v4

OpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
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}

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.

{"stackTrail":"paths:/rest/api/3/priority/{id}:put:responses:204:content:application/json:schema","oasType":"schema","type":"unknown"}