Jira

Jira Issue security schemes API

This resource represents issue security schemes. Use it to get an issue security scheme or a list of issue security schemes. Issue security schemes control which users or groups of users can view an issue. When an issue security scheme is associated with a project, its security levels can be applied to issues in that project. Sub-tasks also inherit the security level of their parent issue.

GitHub OpenAPI

Operations 16

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/issuesecurityschemes List all issue security schemes · Get issue security schemes #
Ask an LLM
“What issue security schemes exist on my Jira site?”
“Can I get every issue security scheme in one unfiltered call?”
Tell an agent
List all issue security schemes.
Show me every issue security scheme configured on the site, unfiltered.
POST /rest/api/3/issuesecurityschemes Create an issue security scheme · Create issue security scheme #
Ask an LLM
“How do I create a new issue security scheme to restrict who sees issues?”
“Can I add security levels and their members while creating the scheme?”
Tell an agent
Create an issue security scheme named {name}.
Create security scheme {name} described as {description} with these levels: {levels}.
GET /rest/api/3/issuesecurityschemes/level List issue security levels across schemes · Get issue security levels #
Ask an LLM
“Which security levels are defined in my issue security schemes?”
“Can I list only the default security level of each scheme?”
Tell an agent
List the issue security levels in scheme {schemeId}.
Show only default security levels ({onlyDefault}) across all security schemes.
PUT /rest/api/3/issuesecurityschemes/level/default Set default security levels for schemes · Set default issue security levels #
Ask an LLM
“How do I change which security level new issues get by default in a scheme?”
“Can I update default security levels for several schemes in one request?”
Tell an agent
Set these default issue security levels per scheme: {defaultValues}.
Update the default level for my security schemes using {defaultValues}.
GET /rest/api/3/issuesecurityschemes/level/member List members of issue security levels · Get issue security level members #
Ask an LLM
“Who is allowed to see issues at a given security level?”
“Can I list security level members for a whole scheme at once?”
Tell an agent
List the members of issue security level {levelId}.
Show all security level members in scheme {schemeId}.
GET /rest/api/3/issuesecurityschemes/project Find projects associated with security schemes · Get projects using issue security schemes #
Ask an LLM
“Which projects use a given issue security scheme?”
“What issue security scheme is assigned to my project?”
Tell an agent
List the projects using issue security scheme {issueSecuritySchemeId}.
Show the security scheme mapping for project {projectId}.
PUT /rest/api/3/issuesecurityschemes/project Assign a security scheme to a project · Associate security scheme to project #
Ask an LLM
“How do I apply an issue security scheme to a project?”
“Can existing issues be moved to new security levels when I swap a project's scheme?”
Tell an agent
Associate issue security scheme {schemeId} with project {projectId}.
Switch project {projectId} to security scheme {schemeId}, remapping issue levels with {oldToNewSecurityLevelMappings}.
GET /rest/api/3/issuesecurityschemes/search Search issue security schemes with paging · Search issue security schemes #
Ask an LLM
“Can I search issue security schemes by ID or by the projects that use them?”
“Is there a paginated way to look up specific issue security schemes?”
Tell an agent
Search issue security schemes {id}.
Find security schemes, with their project IDs, for projects {projectId}.
GET /rest/api/3/issuesecurityschemes/{id} Get a security scheme with its levels · Get issue security scheme #
Ask an LLM
“What security levels does a specific issue security scheme contain?”
“Can a project admin view the security scheme their project uses?”
Tell an agent
Show issue security scheme {id} and its security levels.
Get the details of security scheme {id}.
PUT /rest/api/3/issuesecurityschemes/{id} Rename or redescribe a security scheme · Update issue security scheme #
Ask an LLM
“How do I rename an issue security scheme?”
“Can I change a security scheme's description without touching its levels?”
Tell an agent
Rename issue security scheme {id} to {name}.
Set the description of security scheme {id} to {description}.
DELETE /rest/api/3/issuesecurityschemes/{schemeId} Delete an issue security scheme · Delete issue security scheme #
Ask an LLM
“How do I permanently remove an issue security scheme?”
“Can I delete a security scheme I no longer need?”
Tell an agent destructive · confirm first
Delete issue security scheme {schemeId}.
Remove security scheme {schemeId} from Jira for good.
PUT /rest/api/3/issuesecurityschemes/{schemeId}/level Add security levels to a scheme · Add issue security levels #
Ask an LLM
“How do I add a new security level to an existing security scheme?”
“Can I add levels and their members to a scheme in one call, and how many at a time?”
Tell an agent
Add these security levels to scheme {schemeId}: {levels}.
Create new levels {levels} with their members in existing security scheme {schemeId}.
DELETE /rest/api/3/issuesecurityschemes/{schemeId}/level/{levelId} Remove a security level from a scheme · Remove issue security level #
Ask an LLM
“How do I delete an issue security level?”
“What happens to issues at a security level I remove — can they move to another level?”
Tell an agent destructive · confirm first
Remove security level {levelId} from scheme {schemeId}.
Delete level {levelId} in scheme {schemeId} and move its issues to level {replaceWith}.
PUT /rest/api/3/issuesecurityschemes/{schemeId}/level/{levelId} Rename or redescribe a security level · Update issue security level #
Ask an LLM
“How do I rename an issue security level?”
“Can I edit a security level's description?”
Tell an agent
Rename security level {levelId} in scheme {schemeId} to {name}.
Update the description of level {levelId} in security scheme {schemeId} to {description}.
PUT /rest/api/3/issuesecurityschemes/{schemeId}/level/{levelId}/member Add members to a security level · Add issue security level members #
Ask an LLM
“How do I let more users or groups see issues at a security level?”
“How many members can I add to a security level per request?”
Tell an agent
Add members {members} to security level {levelId} in scheme {schemeId}.
Grant level {levelId} of security scheme {schemeId} access to {members}.
DELETE /rest/api/3/issuesecurityschemes/{schemeId}/level/{levelId}/member/{memberId} Remove a member from a security level · Remove member from issue security level #
Ask an LLM
“How do I stop a user or group from seeing issues at a security level?”
“Can I remove a single member from an issue security level?”
Tell an agent destructive · confirm first
Remove member {memberId} from security level {levelId} in scheme {schemeId}.
Revoke member {memberId}'s access to level {levelId} of security scheme {schemeId}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-security-schemes-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-issue-security-schemes-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-issue-security-schemes-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: ecosystem@atlassian.com
  description: Jira Cloud platform REST API documentation
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  title: Jira Cloud platform REST Issue security schemes API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (90 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-issue-security-schemes-api-openapi.yml