---
title: "Associate security scheme to project"
method: PUT
path: "/rest/api/3/issuesecurityschemes/project"
tags: ["Issue security schemes"]
---

# Associate security scheme to project

`PUT /rest/api/3/issuesecurityschemes/project`

Associates an issue security scheme with a project and remaps security levels of issues to the new levels, if provided.

This operation is [asynchronous](#async). Follow the `location` link in the response to determine the status of the task and use [Get task](#api-rest-api-3-task-taskId-get) to obtain subsequent updates.

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

## Request body

- AssociateSecuritySchemeWithProjectDetails — Issue security scheme, project, and remapping details.
  - `oldToNewSecurityLevelMappings` OldToNewSecurityLevelMappingsBean[] — The list of scheme levels which should be remapped to new levels of the issue security scheme.
    - `newLevelId` string, required — The new issue security level ID. Providing null will clear the assigned old level from issues.
    - `oldLevelId` string, required — The old issue security level ID. Providing null will remap all issues without any assigned levels.
  - `projectId` string, required — The ID of the project.
  - `schemeId` string, required — The ID of the issue security scheme. Providing null will clear the association with the issue security scheme.

## Other responses

- `303` — Returned if the request is successful.
- `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.
- `404` — Returned if the security scheme isn't found.
- `409` — Returned if a task to remove the issue security level is already running.

---

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