# Is Jira giving you a headache?

You were probably searching for a fix for that obscure Jira error. But maybe you found something better.

Stop debugging. Start coordinating.

Qordinate acts as your intelligent layer between apps like Jira and your life. We handle the messy API connections and coordination so you can focus on what actually matters.

# Jira Integration Terminal Errors

## Authentication Errors

### `401 Unauthorized`

```
HTTP 401 Unauthorized
{
  "errorMessages": [\
    "Client must be authenticated to access this resource."\
  ],
  "errors": {}
}
```

### `403 Forbidden`

```
HTTP 403 Forbidden
{
  "errorMessages": [\
    "You do not have permission to perform this operation."\
  ],
  "errors": {}
}
```

## API Errors

### `400 Bad Request`

```
HTTP 400 Bad Request
{
  "errorMessages": [\
    "The request contains invalid properties."\
  ],
  "errors": {
    "summary": "Summary is required.",
    "project": "project is required"
  }
}
```

### `404 Not Found`

```
HTTP 404 Not Found
{
  "errorMessages": [\
    "Issue does not exist or you do not have permission to see it."\
  ],
  "errors": {}
}
```

### `429 Too Many Requests`

```
HTTP 429 Too Many Requests
{
  "errorMessages": [\
    "Too many requests. Please try again later."\
  ],
  "errors": {}
}
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1640995200
```

## SDK-Specific Errors

### Python SDK: `jira.JIRAError`

```python
Traceback (most recent call last):
  File "jira_script.py", line 10, in <module>
    jira = JIRA(server='https://invalid.atlassian.net', basic_auth=('user', 'invalid_password'))
  File "/usr/local/lib/python3.9/site-packages/jira/client.py", line 456, in __init__
    raise JIRAError(text)
jira.JIRAError: Client must be authenticated to access this resource.
```

### Node.js SDK: `JiraApiError`

```javascript
JiraApiError: Issue does not exist or you do not have permission to see it.
    at JiraAPI._request (/node_modules/jira-client/dist/client.js:234:19)
    at processTicksAndRejections (internal/process/task_queues.js:95:5)
    at async JiraAPI.getIssue (/node_modules/jira-client/dist/api.js:123:12)
    at async main (/app/index.js:23:18)
{
  statusCode: 404,
  body: {
    errorMessages: [\
      'Issue does not exist or you do not have permission to see it.'\
    ],
    errors: {}
  },
  headers: {
    'content-type': 'application/json;charset=UTF-8'
  }
}
```

## Jira-Specific Errors

### `PROJECT_NOT_FOUND`

```
HTTP 404 Not Found
{
  "errorMessages": [\
    "Project 'INVALID' not found or you do not have permission to view it."\
  ],
  "errors": {}
}
```

### `ISSUE_TYPE_NOT_FOUND`

```
HTTP 400 Bad Request
{
  "errorMessages": [],
  "errors": {
    "issuetype": "Issue type is required."
  }
}
```

### `FIELD_VALIDATION_ERROR`

```
HTTP 400 Bad Request
{
  "errorMessages": [],
  "errors": {
    "customfield_10001": "Field 'customfield_10001' cannot be set. It is not on the appropriate screen, or unknown.",
    "summary": "Summary must be less than 255 characters."
  }
}
```

## Workflow Errors

### `WORKFLOW_VALIDATION_ERROR`

```
HTTP 400 Bad Request
{
  "errorMessages": [\
    "Workflow validation failed."\
  ],
  "errors": {
    "assignee": "Assignee is required for this transition."
  }
}
```

### `TRANSITION_NOT_FOUND`

```
HTTP 404 Not Found
{
  "errorMessages": [\
    "Transition id '999' is not valid for this issue."\
  ],
  "errors": {}
}
```

## Permission Errors

### `PERMISSION_DENIED`

```
HTTP 403 Forbidden
{
  "errorMessages": [\
    "You cannot edit this issue. It may be locked or you may not have permission to edit it."\
  ],
  "errors": {}
}
```

### `USER_NOT_FOUND`

```
HTTP 404 Not Found
{
  "errorMessages": [\
    "User 'nonexistent@example.com' not found."\
  ],
  "errors": {}
}
```

## Rate Limiting

### `RATE_LIMIT_EXCEEDED`

```
HTTP 429 Too Many Requests
{
  "errorMessages": [\
    "API rate limit exceeded. Please try again later."\
  ],
  "errors": {}
}
Retry-After: 60
```

## Webhook Errors

### `WEBHOOK_URL_INVALID`

```
HTTP 400 Bad Request
{
  "errorMessages": [\
    "The webhook URL is invalid. Webhook URLs must use HTTPS."\
  ],
  "errors": {}
}
```

## Connection Errors

### `Connection Timeout`

```
Error: connect ETIMEDOUT 104.192.143.1:443
    at TCPConnectWrap.afterConnect [as oncomplete] (net.js:1146:16)
```

### `SSL Certificate Error`

```
Error: unable to verify the first certificate
    at TLSSocket.onConnectSecure (_tls_wrap.js:1504:34)
    at TLSSocket.emit (events.js:314:20)
    at TLSSocket._finishInit (_tls_wrap.js:945:8)
    at TLSWrap.ssl.onhandshakedone (_tls_wrap.js:719:12)
```

## JQL Errors

### `INVALID_JQL`

```
HTTP 400 Bad Request
{
  "errorMessages": [\
    "The JQL query is invalid."\
  ],
  "errors": {
    "jql": "Field 'invalidfield' does not exist or you do not have permission to view it."
  }
}
```
