---
title: "Create issue security scheme"
method: POST
path: "/rest/api/3/issuesecurityschemes"
tags: ["Issue security schemes"]
---

# Create issue security scheme

`POST /rest/api/3/issuesecurityschemes`

Creates a security scheme with security scheme levels and levels' members. You can create up to 100 security scheme levels and security scheme levels' members per request.

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

## Request body

- CreateIssueSecuritySchemeDetails — Issue security scheme and it's details
  - `description` string — The description of the issue security scheme.
  - `levels` SecuritySchemeLevelBean[] — The list of scheme levels which should be added to the security scheme.
    - `description` string — The description of the issue security scheme level.
    - `isDefault` boolean — Specifies whether the level is the default level. False by default.
    - `members` SecuritySchemeLevelMemberBean[] — The list of level members which should be added to the issue security scheme level.
      - `parameter` string — The value corresponding to the specified member type.
      - `type` string, required — The issue security level member type, e.g `reporter`, `group`, `user`, `projectrole`, `applicationRole`.
    - `name` string, required — The name of the issue security scheme level. Must be unique.
  - `name` string, required — The name of the issue security scheme. Must be unique (case-insensitive).

## Response `201`

Returned if the request is successful.

- SecuritySchemeId — The ID of the issue security scheme.
  - `id` string, required — The ID of the issue security scheme.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user doesn't have the necessary permission.

---

[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)