Bulk set issues properties by list

POST

/rest/api/3/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

Body Params application/json

Examples

Responses

🔵303303

Returned if the operation is successful.

This response does not have a body.

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/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

400 - Example 1

{
    "errorMessages": [
        "string"
    ],
    "errors": {
        "property1": "string",
        "property2": "string"
    },
    "status": 0
}

Modified at 2025-07-16 07:18:01

Search for issues using JQL enhanced search (POST)

Bulk set issue properties by issue