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, non-empty JSON.

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.

non-transactional. Updating some entities may fail. Such information will available in the task result.

Permissions required:

Browse projects and Edit issues project permissions for the project containing the issue.

If issue-level security is configured, issue-level security permission to view the issue.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/issue/properties/multi' \
--header 'Content-Type: application/json' \
--data-raw '{
    "issues": [
        {
            "issueID": 1000,
            "properties": {
                "myProperty": {
                    "owner": "admin",
                    "weight": 100
                }
            }
        },
        {
            "issueID": 1001,
            "properties": {
                "myOtherProperty": {
                    "cost": 150,
                    "transportation": "car"
                }
            }
        }
    ]
}'

Response Example

303 - Example 1

{}

Request

Body Params application/json

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

array[object (IssueEntityPropertiesForMultiUpdate) {2}]

optional

A list of issue IDs and their respective properties.

issueID

integer <int64>

optional

The ID of the issue.

properties

object

optional

Entity properties to set on the issue. The maximum length of an issue property value is 32768 characters.

Examples

Responses

🔵303Returned if the operation is successful.

application/json

Body

object {0}

🟠400Return if the request is invalid.

🟠401Returned if the authentication credentials are incorrect.

🟠403Return if the user does not have the necessary permission.

Modified at 2023-07-13 03:27:27

Bulk set issues properties by list

Bulk set issue property