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

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

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."
  }
}