---
title: "Bulk edit issues"
method: POST
path: "/rest/api/3/bulk/issues/fields"
tags: ["Issue bulk operations"]
---

# Bulk edit issues

`POST /rest/api/3/bulk/issues/fields`

Use this API to submit a bulk edit request and simultaneously edit multiple issues. There are limits applied to the number of issues and fields that can be edited. A single request can accommodate a maximum of 1000 issues (including subtasks) and 200 fields.

**[Permissions](#permissions) required:**

 *  Global bulk change [permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-global-permissions/).
 *  Browse [project permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/) in all projects that contain the selected issues.
 *  Edit [issues permission](https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/) in all projects that contain the selected issues.
 *  If [issue-level security](https://confluence.atlassian.com/x/J4lKLg) is configured, issue-level security permission to view the issue.

## Request body

- IssueBulkEditPayload — Issue Bulk Edit Payload
  - `editedFieldsInput` JiraIssueFields, required
    - `cascadingSelectFields` JiraCascadingSelectField[] — Add or clear a cascading select field: * To add, specify `optionId` for both parent and child. * To clear the child, set its `optionId` to null. * To clear both, set the parent's `optionId` to null.
      - `childOptionValue` JiraSelectedOptionField
        - `optionId` integer
      - `fieldId` string, required
      - `parentOptionValue` JiraSelectedOptionField, required
        - `optionId` integer
    - `clearableNumberFields` JiraNumberField[] — Add or clear a number field: * To add, specify a numeric `value`. * To clear, set `value` to `null`.
      - `fieldId` string, required
      - `value` number, double
    - `colorFields` JiraColorField[] — Add or clear a color field: * To add, specify the color `name`. Available colors are: `purple`, `blue`, `green`, `teal`, `yellow`, `orange`, `grey`, `dark purple`, `dark blue`, `dark green`, `dark teal`, `dark yellow`, `dark orange`, `dark grey`. * To clear, set the color `name` to an empty string.
      - `color` JiraColorInput, required
        - `name` string, required
      - `fieldId` string, required
    - `datePickerFields` JiraDateField[] — Add or clear a date picker field: * To add, specify the date in `d/mmm/yy` format or ISO format `dd-mm-yyyy`. * To clear, set `formattedDate` to an empty string.
      - `date` JiraDateInput
        - `formattedDate` string, required
      - `fieldId` string, required
    - `dateTimePickerFields` JiraDateTimeField[] — Add or clear the planned start date and time: * To add, specify the date and time in ISO format for `formattedDateTime`. * To clear, provide an empty string for `formattedDateTime`.
      - `dateTime` JiraDateTimeInput, required
        - `formattedDateTime` string, required
      - `fieldId` string, required
    - `issueType` JiraIssueTypeField
      - `issueTypeId` string, required
    - `labelsFields` JiraLabelsField[] — Edit a labels field: * Options include `ADD`, `REPLACE`, `REMOVE`, or `REMOVE_ALL` for bulk edits. * To clear labels, use the `REMOVE_ALL` option with an empty `labels` array.
      - `bulkEditMultiSelectFieldOption` 'ADD' | 'REMOVE' | 'REPLACE' | 'REMOVE_ALL', required
      - `fieldId` string, required
      - `labelProperties` JiraLabelPropertiesInputJackson1[]
        - `color` 'GREY_LIGHTEST' | 'GREY_LIGHTER' | 'GREY' | 'GREY_DARKER' | 'GREY_DARKEST' | 'PURPLE_LIGHTEST' | 'PURPLE_LIGHTER' | 'PURPLE' | 'PURPLE_DARKER' | 'PURPLE_DARKEST' | 'BLUE_LIGHTEST' | 'BLUE_LIGHTER' | 'BLUE' | 'BLUE_DARKER' | 'BLUE_DARKEST' | 'TEAL_LIGHTEST' | 'TEAL_LIGHTER' | 'TEAL' | 'TEAL_DARKER' | 'TEAL_DARKEST' | 'GREEN_LIGHTEST' | 'GREEN_LIGHTER' | 'GREEN' | 'GREEN_DARKER' | 'GREEN_DARKEST' | 'LIME_LIGHTEST' | 'LIME_LIGHTER' | 'LIME' | 'LIME_DARKER' | 'LIME_DARKEST' | 'YELLOW_LIGHTEST' | 'YELLOW_LIGHTER' | 'YELLOW' | 'YELLOW_DARKER' | 'YELLOW_DARKEST' | 'ORANGE_LIGHTEST' | 'ORANGE_LIGHTER' | 'ORANGE' | 'ORANGE_DARKER' | 'ORANGE_DARKEST' | 'RED_LIGHTEST' | 'RED_LIGHTER' | 'RED' | 'RED_DARKER' | 'RED_DARKEST' | 'MAGENTA_LIGHTEST' | 'MAGENTA_LIGHTER' | 'MAGENTA' | 'MAGENTA_DARKER' | 'MAGENTA_DARKEST'
        - `name` string
      - `labels` JiraLabelsInput[], required
        - `name` string, required
    - `multipleGroupPickerFields` JiraMultipleGroupPickerField[] — Add or clear a multi-group picker field: * To add groups, provide an array of groups with `groupName`s. * To clear all groups, use an empty `groups` array.
      - `fieldId` string, required
      - `groups` JiraGroupInput[], required
        - `groupName` string, required
    - `multipleSelectClearableUserPickerFields` JiraMultipleSelectUserPickerField[] — Assign or unassign multiple users to/from a field: * To assign, provide an array of user `accountId`s. * To clear, set `users` to `null`.
      - `fieldId` string, required
      - `users` JiraUserField[]
        - `accountId` string, required
    - `multipleSelectFields` JiraMultipleSelectField[] — Add or clear a multi-select field: * To add, provide an array of options with `optionId`s. * To clear, use an empty `options` array.
      - `fieldId` string, required
      - `options` JiraSelectedOptionField[], required
        - `optionId` integer
    - `multipleVersionPickerFields` JiraMultipleVersionPickerField[] — Edit a multi-version picker field like Fix Versions/Affects Versions: * Options include `ADD`, `REPLACE`, `REMOVE`, or `REMOVE_ALL` for bulk edits. * To clear the field, use the `REMOVE_ALL` option with an empty `versions` array.
      - `bulkEditMultiSelectFieldOption` 'ADD' | 'REMOVE' | 'REPLACE' | 'REMOVE_ALL', required
      - `fieldId` string, required
      - `versions` JiraVersionField[], required
        - `versionId` string
    - `multiselectComponents` JiraMultiSelectComponentField
      - `bulkEditMultiSelectFieldOption` 'ADD' | 'REMOVE' | 'REPLACE' | 'REMOVE_ALL', required
      - `components` JiraComponentField[], required
        - `componentId` integer, required
      - `fieldId` string, required
    - `originalEstimateField` JiraDurationField
      - `originalEstimateField` string, required
    - `priority` JiraPriorityField
      - `priorityId` string, required
    - `richTextFields` JiraRichTextField[] — Add or clear a rich text field: * To add, provide `adfValue`. Note that rich text fields only support ADF values. * To clear, use an empty `richText` object. For ADF format details, refer to: [Atlassian Document Format](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure).
      - `fieldId` string, required
      - `richText` JiraRichTextInput, required
        - `adfValue` object
    - `singleGroupPickerFields` JiraSingleGroupPickerField[] — Add or clear a single group picker field: * To add, specify the group with `groupName`. * To clear, set `groupName` to an empty string.
      - `fieldId` string, required
      - `group` JiraGroupInput, required
        - `groupName` string, required
    - `singleLineTextFields` JiraSingleLineTextField[] — Add or clear a single line text field: * To add, provide the `text` value. * To clear, set `text` to an empty string.
      - `fieldId` string, required
      - `text` string, required
    - `singleSelectClearableUserPickerFields` JiraSingleSelectUserPickerField[] — Edit assignment for single select user picker fields like Assignee/Reporter: * To assign an issue, specify the user's `accountId`. * To unassign an issue, set `user` to `null`. * For automatic assignment, set `accountId` to `-1`.
      - `fieldId` string, required
      - `user` JiraUserField
        - `accountId` string, required
    - `singleSelectFields` JiraSingleSelectField[] — Add or clear a single select field: * To add, specify the option with an `optionId`. * To clear, pass an option with `optionId` as `-1`.
      - `fieldId` string, required
      - `option` JiraSelectedOptionField, required
        - `optionId` integer
    - `singleVersionPickerFields` JiraSingleVersionPickerField[] — Add or clear a single version picker field: * To add, specify the version with a `versionId`. * To clear, set `versionId` to `-1`.
      - `fieldId` string, required
      - `version` JiraVersionField, required
        - `versionId` string
    - `status` JiraStatusInput
      - `statusId` string, required
    - `timeTrackingField` JiraTimeTrackingField
      - `timeRemaining` string, required
    - `urlFields` JiraUrlField[] — Add or clear a URL field: * To add, provide the `url` with the desired URL value. * To clear, set `url` to an empty string.
      - `fieldId` string, required
      - `url` string, required
  - `selectedActions` string[], required — List of all the field IDs that are to be bulk edited. Each field ID in this list corresponds to a specific attribute of an issue that is set to be modified in the bulk edit operation. The relevant field ID can be obtained by calling the Bulk Edit Get Fields REST API (documentation available on this page itself).
  - `selectedIssueIdsOrKeys` string[], required — List of issue IDs or keys which are to be bulk edited. These IDs or keys can be from different projects and issue types.
  - `sendBulkNotification` boolean, nullable — A boolean value that indicates whether to send a bulk change notification when the issues are being edited. If `true`, dispatches a bulk notification email to users about the updates.

## Response `201`

Returned if the request is successful.

- SubmittedBulkOperation
  - `taskId` string

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)