Suggested priorities for mappings

POST

/rest/api/3/priorityscheme/mappings

Returns a paginated list of priorities that would require mapping, given a change in priorities or projects associated with a priority scheme.

Permissions required: Permission to access Jira.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/priorityscheme/mappings' \
--header 'Content-Type: application/json' \
--data-raw '{
    "maxResults": 50,
    "priorities": {
        "add": [
            10001,
            10002
        ],
        "remove": [
            10003
        ]
    },
    "projects": {
        "add": [
            10021
        ]
    },
    "schemeId": 10005,
    "startAt": 0
}'

Response Example

{"isLast":true,"maxResults":50,"startAt":0,"total":3,"values":[{"description":"Serious problem that could block progress.","iconUrl":"/images/icons/priorities/high.svg","id":"1","isDefault":false,"name":"High","statusColor":"#f15C75"},{"description":"Has the potential to affect progress.","iconUrl":"/images/icons/priorities/medium.svg","id":"2","isDefault":true,"name":"Medium","statusColor":"#f79232"},{"description":"Minor problem or easily worked around.","iconUrl":"/images/icons/priorities/low.svg","id":"3","isDefault":false,"name":"Low","statusColor":"#707070"}]}

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-07-16 07:18:01

Create priority scheme

Get available priorities by priority scheme