---
title: "Submit Security Workspaces to link"
method: POST
path: "/rest/security/1.0/linkedWorkspaces/bulk"
tags: ["Security Information"]
---

# Submit Security Workspaces to link

`POST /rest/security/1.0/linkedWorkspaces/bulk`

Insert Security Workspace IDs to establish a relationship between them and the Jira site the app is installed on. If a relationship between the workspace ID and Jira already exists then the workspace ID will be ignored and Jira will process the rest of the entries.

## Request body

- object — The payload used to submit (update / insert) Security Workspace IDs.
  - `workspaceIds` string[], required — The IDs of Security Workspaces to link to this Jira site. These must follow this regex pattern: `[a-zA-Z0-9\\-_.~@:{}=]+(\/[a-zA-Z0-9\\-_.~@:{}=]+)*`

## Response `202`

Submission accepted. Each submitted Security Workspace ID will be linked to Jira.

## Other responses

- `400` — Request has incorrect format.
- `401` — Missing a JWT token, or token is invalid.
- `403` — The app does not define a security info provider module, or does not have the required scope to access this resource.
- `413` — Set of Ids is too large. Submit fewer Ids in each payload.
- `429` — API rate limit has been exceeded.
- `503` — Service is unavailable due to maintenance or other reasons.
- `default` — An unknown error has occurred.

---

[API](https://skmtc.net/atlassian/apis/jira-software-cloud-api.md) · [All operations](https://skmtc.net/atlassian/apis/jira-software-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jira-software-cloud-api/revisions/4e108d54b990/schema)