---
title: "Bulk set issue properties by issue"
method: POST
path: "/rest/api/3/issue/properties/multi"
tags: ["Issue properties"]
---

# Bulk set issue properties by issue

`POST /rest/api/3/issue/properties/multi`

Sets or updates entity property values on issues. Up to 10 entity properties can be specified for each issue and up to 100 issues included in the request.

The value of the request body must be a [valid](http://tools.ietf.org/html/rfc4627), non-empty JSON.

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.
 *  non-transactional. Updating some entities may fail. Such information will available in the task result.

**[Permissions](#permissions) required:**

 *  *Browse projects* and *Edit issues* [project permissions](https://confluence.atlassian.com/x/yodKLg) for the project containing the issue.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Request body

- MultiIssueEntityProperties — A list of issues and their respective properties to set or update. See [Entity properties](https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/) for more information.
  - `issues` IssueEntityPropertiesForMultiUpdate[] — A list of issue IDs and their respective properties.
    - `issueID` integer — The ID of the issue.
    - `properties` object — Entity properties to set on the issue. The maximum length of an issue property value is 32768 characters.

## Other responses

- `303` — Returned if the operation is successful.
- `400` — Return if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect.
- `403` — Return if the user does not have the necessary permission.
- `409` — Returned if another bulk update on the same issues is already in progress. Retry the request later.

---

[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/5a51740d7ab3/schema)