Bulk set issue property

Sets a property value on multiple issues.

The value set can be a constant or determined by a Jira expression. Expressions must be computable with constant complexity when applied to a set of issues. Expressions must also comply with the restrictions that apply to all Jira expressions.

The issues to be updated can be specified by a filter.

The filter identifies issues eligible for update using these criteria:

entityIds Only issues from this list are eligible.

currentValue Only issues with the property set to this value are eligible.

hasProperty:

If true, only issues with the property are eligible.

If false, only issues without the property are eligible.

If more than one criteria is specified, they are joined with the logical AND: only issues that satisfy all criteria are eligible.

If an invalid combination of criteria is provided, an error is returned. For example, specifying a currentValue and hasProperty as false would not match any issues (because without the property the property cannot have a value).

The filter is optional. Without the filter all the issues visible to the user and where the user has the EDIT_ISSUES permission for the issue are considered eligible.

This operation is:

transactional, either all eligible issues are updated or, when errors occur, none 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 project permission for each project containing issues.

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

Edit issues project permission for each issue.

curl --location --request PUT 'http://jira.local:8080/jira/rest//rest/api/3/issue/properties/' \ --header 'Content-Type: application/json' \ --data-raw '{ "filter": { "currentValue": { "owner": "admin", "weight": 50 }, "entityIds": [ 10100, 100010 ], "hasProperty": true }, "value": { "owner": "admin", "weight": 100 } }'

Request

Path Params

propertyKey

string

required

The key of the property. The maximum length is 255 characters.

Body Params application/json

Bulk issue property update request details.

expression

string

optional

EXPERIMENTAL. The Jira expression to calculate the value of the property. The value of the expression must be an object that can be converted to JSON, such as a number, boolean, string, list, or map. The context variables available to the expression are issue and user. Issues for which the expression returns a value whose JSON representation is longer than 32768 characters are ignored.

filter

object

optional

The bulk operation filter.

currentValue

optional

The value of properties to perform the bulk operation on.

entityIds

array[integer <int64>]

optional

List of issues to perform the bulk operation on.

hasProperty

boolean

optional

Whether the bulk operation occurs only when the property is present on or absent from an issue.

value

optional

The value of the property. The value must be a valid, non-empty JSON blob. The maximum length is 32768 characters.

Examples

Bulk set issue property

Request

Responses