Atlassian Permission Schemes API

The Permission Schemes API from Atlassian — 4 operation(s) for permission schemes.

Documentation GitHub OpenAPI

Business capability

Operations 9

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/api/3/permissionscheme List all permission schemes · Atlassian Get All Permission Schemes #

Ask an LLM

“Which permission schemes are defined in my Jira site?”

“Can I list permission schemes with their grants expanded?”

Tell an agent

List all permission schemes.

Show every permission scheme with {expand} expanded.

POST /rest/api/3/permissionscheme Create a permission scheme · Atlassian Create Permission Scheme #

Ask an LLM

“How do I create a new Jira permission scheme?”

“Can I create a permission scheme with no grants and add them later?”

Tell an agent

Create permission scheme {name}.

Create permission scheme {name} with grants {permissions}.

DELETE /rest/api/3/permissionscheme/{schemeId} Delete a permission scheme · Atlassian Delete Permission Scheme #

Ask an LLM

“How do I delete a permission scheme that's no longer used?”

“Who is allowed to remove a Jira permission scheme?”

Tell an agent destructive · confirm first

Delete permission scheme {schemeId}.

Remove the unused permission scheme {schemeId}.

GET /rest/api/3/permissionscheme/{schemeId} Get a permission scheme · Atlassian Get Permission Scheme #

Ask an LLM

“How do I look up a single permission scheme by id?”

“What name and description does this permission scheme have?”

Tell an agent

Get permission scheme {schemeId}.

Show permission scheme {schemeId} with {expand} expanded.

PUT /rest/api/3/permissionscheme/{schemeId} Update a permission scheme · Atlassian Update Permission Scheme #

Ask an LLM

“Will sending a permissions list overwrite all existing grants in the scheme?”

“How do I rename a permission scheme without touching its grants?”

Tell an agent

Rename permission scheme {schemeId} to {name}.

Replace all grants in scheme {schemeId} named {name} with {permissions}.

GET /rest/api/3/permissionscheme/{schemeId}/permission List the grants in a permission scheme · Atlassian Get Permission Scheme Grants #

Ask an LLM

“Who has which permission under this scheme?”

“What grants does a permission scheme contain?”

Tell an agent

List all permission grants in scheme {schemeId}.

Show the holders and permissions granted by scheme {schemeId}.

POST /rest/api/3/permissionscheme/{schemeId}/permission Add a permission grant to a scheme · Atlassian Create Permission Grant #

Ask an LLM

“How do I give a group a permission inside a permission scheme?”

“Can I add a single grant without rewriting the whole scheme?”

Tell an agent

Grant {permission} to holder {holder} in scheme {schemeId}.

Add a new grant of {permission} to permission scheme {schemeId}.

DELETE /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId} Remove a permission grant from a scheme · Atlassian Delete Permission Scheme Grant #

Ask an LLM

“How do I revoke one grant from a permission scheme?”

“Can I remove a single holder's permission without editing the whole scheme?”

Tell an agent destructive · confirm first

Delete grant {permissionId} from permission scheme {schemeId}.

Revoke permission grant {permissionId} in scheme {schemeId}.

GET /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId} Get one permission grant · Atlassian Get Permission Scheme Grant #

Ask an LLM

“How do I inspect a single grant inside a permission scheme?”

“Which holder does this permission grant apply to?”

Tell an agent

Get grant {permissionId} in permission scheme {schemeId}.

Show me permission grant {permissionId} of scheme {schemeId}.

Atlassian Permission Schemes API

Operations 9

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification