bulkDeleteIssueProperty method

Future<void> bulkDeleteIssueProperty({
  1. required String propertyKey,
  2. required IssueFilterForBulkPropertyDelete body,
})

Deletes a property value from multiple issues. The issues to be updated can be specified by filter criteria.

The criteria the filter used to identify eligible issues are:

  • entityIds Only issues from this list are eligible.
  • currentValue Only issues with the property set to this value are eligible.

If both criteria is specified, they are joined with the logical AND: only issues that satisfy both criteria are considered eligible.

If no filter criteria are specified, 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 the property is deleted from all eligible issues or, when errors occur, no properties are deleted.
  • 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:

Implementation

Future<void> bulkDeleteIssueProperty(
    {required String propertyKey,
    required IssueFilterForBulkPropertyDelete body}) async {
  await _client.send(
    'delete',
    'rest/api/3/issue/properties/{propertyKey}',
    pathParameters: {
      'propertyKey': propertyKey,
    },
    body: body.toJson(),
  );
}