Bulk set issues properties by list

POST

/rest/api/3/issue/properties

Issue properties

Sets or updates a list of entity property values on issues. A list of up to 10 entity properties can be specified along with up to 10,000 issues on which to set or update that list of entity properties.

The value of the request body must be a valid, non-empty JSON. The maximum length of single issue property value is 32768 characters. This operation can be accessed anonymously.

This operation is:

transactional, either all properties are updated in all eligible issues or, when errors occur, no properties are updated.

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:

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' \
--header 'Content-Type: application/json' \
--data-raw '{
    "entitiesIds": [
        0
    ],
    "properties": {
        "property1": {
            "array": true,
            "bigDecimal": true,
            "bigInteger": true,
            "bigIntegerValue": 0,
            "binary": true,
            "binaryValue": [
                "string"
            ],
            "boolean": true,
            "booleanValue": true,
            "containerNode": true,
            "decimalValue": 0,
            "double": true,
            "doubleValue": 0,
            "elements": {},
            "fieldNames": {},
            "fields": {},
            "floatingPointNumber": true,
            "int": true,
            "intValue": 0,
            "integralNumber": true,
            "long": true,
            "longValue": 0,
            "missingNode": true,
            "null": true,
            "number": true,
            "numberType": "INT",
            "numberValue": 0,
            "object": true,
            "pojo": true,
            "textValue": "string",
            "textual": true,
            "valueAsBoolean": true,
            "valueAsDouble": 0,
            "valueAsInt": 0,
            "valueAsLong": 0,
            "valueAsText": "string",
            "valueNode": true
        },
        "property2": {
            "array": true,
            "bigDecimal": true,
            "bigInteger": true,
            "bigIntegerValue": 0,
            "binary": true,
            "binaryValue": [
                "string"
            ],
            "boolean": true,
            "booleanValue": true,
            "containerNode": true,
            "decimalValue": 0,
            "double": true,
            "doubleValue": 0,
            "elements": {},
            "fieldNames": {},
            "fields": {},
            "floatingPointNumber": true,
            "int": true,
            "intValue": 0,
            "integralNumber": true,
            "long": true,
            "longValue": 0,
            "missingNode": true,
            "null": true,
            "number": true,
            "numberType": "INT",
            "numberValue": 0,
            "object": true,
            "pojo": true,
            "textValue": "string",
            "textual": true,
            "valueAsBoolean": true,
            "valueAsDouble": 0,
            "valueAsInt": 0,
            "valueAsLong": 0,
            "valueAsText": "string",
            "valueNode": true
        }
    }
}'

Response Example

303 - Example 1

{}

Request

Body Params application/json

Lists of issues and entity properties. See [Entity properties](https://developer.atlassian.com/cloud/jira/platform/jira-entity-properties/) for more information.

entitiesIds

array[integer <int64>]

optional

A list of entity property IDs.

>= 1 items<= 10000 items

properties

object

optional

A list of entity property keys and values.

Additional properties

object (JsonNode)

optional

Examples

Responses

🔵303Returned if the operation is successful.

application/json

Body

object {0}

🟠400Return if the request is invalid or the user does not have the necessary permission.

🟠401Returned if the authentication credentials are incorrect.

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

Search for issues using JQL (POST)

Bulk set issue properties by issue