Associate security scheme to 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. Follow the location link in the response to determine the status of the task and use Get task to obtain subsequent updates.

Permissions required: Administer Jira global permission.

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/issuesecurityschemes/project' \ --header 'Content-Type: application/json' \ --data-raw '{ "oldToNewSecurityLevelMappings": [ { "newLevelId": "30001", "oldLevelId": "30000" } ], "projectId": "10000", "schemeId": "20000" }'

{ "description": "string", "elapsedRuntime": 0, "finished": 0, "id": "string", "lastUpdate": 0, "message": "string", "progress": 0, "result": null, "self": "http://example.com", "started": 0, "status": "ENQUEUED", "submitted": 0, "submittedBy": 0 }

Request

Body Params application/json

Issue security scheme, project, and remapping details.

oldToNewSecurityLevelMappings

array[object (OldToNewSecurityLevelMappingsBean) {2}]

write-onlyoptional

The list of scheme levels which should be remapped to new levels of the issue security scheme.

newLevelId

string

write-onlyrequired

The new issue security level ID. Providing null will clear the assigned old level from issues.

oldLevelId

string

write-onlyrequired

The old issue security level ID. Providing null will remap all issues without any assigned levels.

projectId

string

write-onlyrequired

The ID of the project.

schemeId

string

write-onlyrequired

The ID of the issue security scheme. Providing null will clear the association with the issue security scheme.

Examples

Responses

🔵303Returned if the request is successful.

application/json

Body

Details about a task.

description

string

optional

The description of the task.

elapsedRuntime

integer <int64>

required

The execution time of the task, in milliseconds.

finished

integer <int64>

optional

A timestamp recording when the task was finished.

string

required

The ID of the task.

lastUpdate

integer <int64>

required

A timestamp recording when the task progress was last updated.

message

string

optional

Information about the progress of the task.

progress

integer <int64>

required

The progress of the task, as a percentage complete.

result

optional

The result of the task execution.

self

string <uri>

required

The URL of the task.

started

integer <int64>

optional

A timestamp recording when the task was started.

status

enum<string>

required

The status of the task.

Allowed values:

ENQUEUEDRUNNINGCOMPLETEFAILEDCANCEL_REQUESTEDCANCELLEDDEAD

submitted

integer <int64>

required

A timestamp recording when the task was submitted.

submittedBy

integer <int64>

required

The ID of the user who submitted the task.

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user doesn't have the necessary permission.

🟠404Returned if the security scheme isn't found.

🟠409Returned if a task to remove the issue security level is already running.