---
title: "Update priority"
method: PUT
path: "/rest/api/2/priority/{id}"
tags: ["Issue priorities"]
---

# Update priority

`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](https://developer.atlassian.com/changelog/#CHANGE-1525).

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `id` string, required

## Request body

- UpdatePriorityDetails — Details of an issue priority.
  - `avatarId` integer — The ID for the avatar for the priority. This parameter is nullable and both iconUrl and avatarId cannot be defined.
  - `description` string, 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.
  - `name` string, nullable — The name of the priority. Must be unique.
  - `statusColor` string, nullable — The status color of the priority in 3-digit or 6-digit hexadecimal format.

## Response `204`

Returned if the request is successful.

- unknown

## Other responses

- `400` — Returned if the request isn't valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user doesn't have the necessary permission.
- `404` — Returned if the issue priority isn't found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)