PUT /rest/api/2/priority/{id}

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.

Servers

Path parameters

Name Type Required Description
id String Yes

The ID of the issue priority.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
statusColor String No

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

name String No

The name of the priority. Must be unique.

description String No

The description of the priority.

iconUrl String No

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.

Valid values:

  • "/images/icons/priorities/trivial_new.png"
  • "/images/icons/priorities/highest_new.png"
  • "/images/icons/priorities/highest.png"
  • "/images/icons/priorities/low.png"
  • "/images/icons/priorities/trivial.png"
  • "/images/icons/priorities/blocker.png"
  • "/images/icons/priorities/high.png"
  • "/images/icons/priorities/medium.png"
  • "/images/icons/priorities/minor.png"
  • "/images/icons/priorities/critical_new.png"
  • "/images/icons/priorities/lowest.png"
  • "/images/icons/priorities/lowest_new.png"
  • "/images/icons/priorities/major_new.png"
  • "/images/icons/priorities/critical.png"
  • "/images/icons/priorities/high_new.png"
  • "/images/icons/priorities/low_new.png"
  • "/images/icons/priorities/blocker_new.png"
  • "/images/icons/priorities/minor_new.png"
  • "/images/icons/priorities/major.png"
  • "/images/icons/priorities/medium_new.png"
avatarId Integer No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.