provider Priority schemes POST /rest/api/3/priorityscheme
@utdk/jira /rest/api/3/priorityscheme
Create priority scheme
Creates a new priority scheme. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

Try it

Authentication
Configure credentials for The Jira Cloud platform REST API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

createpriorityscheme
POST/rest/api/3/priorityscheme
Creates a new priority scheme. **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

Input

required

The ID of the default priority for the priority scheme.

The description of the priority scheme.

Instructions to migrate the priorities of issues. `in` mappings are used to migrate the priorities of issues to priorities used within the priority scheme. `out` mappings are used to migrate the priorities of issues to priorities not used within the priority scheme. * When **priorities** are **added** to the new priority scheme, no mapping needs to be provided as the new priorities are not used by any issues. * When **priorities** are **removed** from the new priority scheme, no mapping needs to be provided as the removed priorities are not used by any issues. * When **projects** are **added** to the priority scheme, the priorities of issues in those projects might need to be migrated to new priorities used by the priority scheme. This can occur when the current scheme does not use all the priorities in the project(s)' priority scheme(s). * An `in` mapping must be provided for each of these priorities. * When **projects** are **removed** from the priority scheme, no mapping needs to be provided as the removed projects are not using the priorities of the new priority scheme. For more information on `in` and `out` mappings, see the child properties documentation for the `PriorityMapping` object below.

required

The name of the priority scheme. Must be unique.

required

The IDs of priorities in the scheme.

The IDs of projects that will use the priority scheme.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import jira from '@utdk/jira';

await jira.createpriorityscheme()