---
title: "Suggested priorities for mappings"
method: POST
path: "/rest/api/3/priorityscheme/mappings"
tags: ["Priority schemes"]
---

# Suggested priorities for mappings

`POST /rest/api/3/priorityscheme/mappings`

Returns a [paginated](#pagination) list of priorities that would require mapping, given a change in priorities or projects associated with a priority scheme.

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

## Request body

- SuggestedMappingsRequestBean — Details of changes to a priority scheme that require suggested priority mappings.
  - `maxResults` integer — The maximum number of results that could be on the page.
  - `priorities` SuggestedMappingsForPrioritiesRequestBean — Details of changes to a priority scheme's priorities that require suggested priority mappings.
    - `add` integer[] — The ids of priorities being removed from the scheme.
    - `remove` integer[] — The ids of priorities being removed from the scheme.
  - `projects` SuggestedMappingsForProjectsRequestBean — Details of changes to a priority scheme's projects that require suggested priority mappings.
    - `add` integer[] — The ids of projects being added to the scheme.
  - `schemeId` integer — The id of the priority scheme.
  - `startAt` integer — The index of the first item returned on the page.

## Response `200`

Returned if the request is successful.

- PageBeanPriorityWithSequence — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` PriorityWithSequence[] — The list of items.
    - `description` string — The description of the issue priority.
    - `iconUrl` string — The URL of the icon for the issue priority.
    - `id` string — The ID of the issue priority.
    - `isDefault` boolean — Whether this priority is the default.
    - `name` string — The name of the issue priority.
    - `self` string — The URL of the issue priority.
    - `sequence` string — The sequence of the issue priority.
    - `statusColor` string — The color used to indicate the issue priority.

## Other responses

- `400` — Returned if the request isn't valid.
- `401` — Returned if the authentication credentials are incorrect.

---

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