Create permission scheme

POST

/rest/api/3/permissionscheme

Creates a new permission scheme. You can create a permission scheme with or without defining a set of permission grants.

Permissions required: Administer Jira global permission.

Request

Query Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Returned if the permission scheme is created.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/permissionscheme' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "description",
    "name": "Example permission scheme",
    "permissions": [
        {
            "holder": {
                "parameter": "jira-core-users",
                "type": "group",
                "value": "ca85fac0-d974-40ca-a615-7af99c48d24f"
            },
            "permission": "ADMINISTER_PROJECTS"
        }
    ]
}'

Response Example

{"description":"description","id":10000,"name":"Example permission scheme","permissions":[{"holder":{"expand":"group","parameter":"jira-core-users","type":"group","value":"ca85fac0-d974-40ca-a615-7af99c48d24f"},"id":10000,"permission":"ADMINISTER_PROJECTS","self":"https://your-domain.atlassian.net/rest/api/3/permissionscheme/permission/10000"}],"self":"https://your-domain.atlassian.net/rest/api/3/permissionscheme/10000"}

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

Get all permission schemes

Delete permission scheme