ATatlassian
Issue priorities

Update priority

Updates an issue priority.

At least one request body parameter must be defined.

Deprecation notice: The iconUrl parameter was sunset on 16th Mar 2025, and replaced with avatarId. See CHANGE-1525.

Permissions required: Administer Jira global permission.

put/rest/api/3/priority/{id}

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/priority/{id}
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: manage:jira-configuration

Path parameters

idstring required

The ID of the issue priority.

Request body

avatarIdinteger

The ID for the avatar for the priority. This parameter is nullable and both iconUrl and avatarId cannot be defined.

descriptionstring nullable

The description of the priority.

iconUrl'/images/icons/priorities/blocker.png' | '/images/icons/priorities/critical.png' | '/images/icons/priorities/high.png' | '/images/icons/priorities/highest.png' | '/images/icons/priorities/low.png' | '/images/icons/priorities/lowest.png' | '/images/icons/priorities/major.png' | '/images/icons/priorities/medium.png' | '/images/icons/priorities/minor.png' | '/images/icons/priorities/trivial.png' | '/images/icons/priorities/blocker_new.png' | '/images/icons/priorities/critical_new.png' | '/images/icons/priorities/high_new.png' | '/images/icons/priorities/highest_new.png' | '/images/icons/priorities/low_new.png' | '/images/icons/priorities/lowest_new.png' | '/images/icons/priorities/major_new.png' | '/images/icons/priorities/medium_new.png' | '/images/icons/priorities/minor_new.png' | '/images/icons/priorities/trivial_new.png' nullable

The URL of an icon for the priority. Accepted protocols are HTTP and HTTPS. Built in icons can also be used. Both iconUrl and avatarId cannot be defined.

namestring nullable

The name of the priority. Must be unique.

statusColorstring nullable

The status color of the priority in 3-digit or 6-digit hexadecimal format.

Response

Returned if the request is successful.

unknown required

Changes

No recorded changes to this operation across all 31 revisions of this API.