Issue priorities

Update priority

Changed on

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

  • 23cd462c2497Revision changes
    • info

      endpoint reactivated

  • 6abe311e7b55Revision changes
    • info

      endpoint deprecated

    • info

      added the new optional request property

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      added the new /images/icons/priorities/blocker_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/critical_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/high_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/highest_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/low_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/lowest_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/major_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/medium_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/minor_new.png enum value to the request property

    • info

      added the new /images/icons/priorities/trivial_new.png enum value to the request property