Jira Issue Tracking

20 known error codes

FIELD_VALIDATION_FAILED Easy Fix

One or more Jira field values failed server validation constraints.

INVALID_JQL Easy Fix

JQL query expression is invalid or references unknown fields.

ISSUE_ALREADY_CLOSED Moderate

Issue is already in a terminal state for the requested update.

JIRA-400-BAD_REQUEST Easy Fix

Jira rejected request as syntactically or semantically invalid.

JIRA-401-UNAUTHORIZED Easy Fix

Jira request is missing valid authentication context.

JIRA-403-FORBIDDEN Easy Fix

Authenticated principal cannot perform this project/issue action.

JIRA-404-NOT_FOUND Easy Fix

Issue, project, or board resource was not found.

JIRA-409-CONFLICT Moderate

Jira state conflict occurred during issue update or transition.

JIRA-412-PRECONDITION_FAILED Moderate

Jira precondition headers/version checks failed for this mutation.

JIRA-413-PAYLOAD_TOO_LARGE Easy Fix

Request payload exceeds Jira API size limits.

JIRA-415-UNSUPPORTED_MEDIA_TYPE Easy Fix

Content-Type is unsupported for the Jira endpoint.

JIRA-422-UNPROCESSABLE_ENTITY Easy Fix

Jira could parse payload but business validation failed.

JIRA-429-RATE_LIMITED Moderate

Jira API throttled request due to rate-limit policy.

JIRA-500-INTERNAL_ERROR Call a Pro

Unexpected Jira backend error occurred while processing request.

JIRA-502-BAD_GATEWAY Moderate

Jira edge gateway received invalid upstream response.

JIRA-503-SERVICE_UNAVAILABLE Call a Pro

Jira service temporarily unavailable due to maintenance/load.

JIRA-504-GATEWAY_TIMEOUT Moderate

Jira gateway timed out waiting for backend response.

PERMISSION_VIOLATION Easy Fix

Operation violates Jira permission scheme for this project.

TRANSITION_NOT_ALLOWED Moderate

Requested workflow transition is invalid from current issue status.

WORKLOG_LOCKED Moderate

Worklog entry is locked by period or policy and cannot be edited.