POST /rest/api/2/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
locationlink 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.
Servers
- https://your-domain.atlassian.net
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
properties |
Object | No |
A list of entity property keys and values. |
properties.name |
Object | No | |
properties.name.binary |
Boolean | No | |
properties.name.array |
Boolean | No | |
properties.name.valueAsInt |
Integer | No | |
properties.name.long |
Boolean | No | |
properties.name.boolean |
Boolean | No | |
properties.name.valueAsText |
String | No | |
properties.name.fieldNames |
Object | No | |
properties.name.bigDecimal |
Boolean | No | |
properties.name.booleanValue |
Boolean | No | |
properties.name.pojo |
Boolean | No | |
properties.name.null |
Boolean | No | |
properties.name.longValue |
Integer | No | |
properties.name.valueNode |
Boolean | No | |
properties.name.intValue |
Integer | No | |
properties.name.textValue |
String | No | |
properties.name.valueAsDouble |
Number | No | |
properties.name.doubleValue |
Number | No | |
properties.name.containerNode |
Boolean | No | |
properties.name.int |
Boolean | No | |
properties.name.missingNode |
Boolean | No | |
properties.name.bigInteger |
Boolean | No | |
properties.name.number |
Boolean | No | |
properties.name.bigIntegerValue |
Integer | No | |
properties.name.binaryValue[] |
Array | No | |
properties.name.fields |
Object | No | |
properties.name.valueAsLong |
Integer | No | |
properties.name.elements |
Object | No | |
properties.name.numberValue |
Number | No | |
properties.name.floatingPointNumber |
Boolean | No | |
properties.name.double |
Boolean | No | |
properties.name.object |
Boolean | No | |
properties.name.textual |
Boolean | No | |
properties.name.valueAsBoolean |
Boolean | No | |
properties.name.numberType |
String | No |
Possible values:
|
properties.name.decimalValue |
Number | No | |
properties.name.integralNumber |
Boolean | No | |
entitiesIds[] |
Array | No |
A list of entity property IDs. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.