# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Cloud platform REST Issue bulk operations API
  version: 1.0.0
extends: openapi/jira-issue-bulk-operations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/rest/api/3/bulk/issues/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete many issues in one request
      effect: destructive
      questions:
      - How do I delete hundreds of issues at once?
      - What's the maximum number of issues a single bulk delete can remove?
      instructions:
      - text: Bulk delete issues {selectedIssueIdsOrKeys}.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
      - text: Delete issues {selectedIssueIdsOrKeys} with bulk notification set to {sendBulkNotification}.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
          sendBulkNotification: requestBody.sendBulkNotification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List fields that can be bulk edited on issues
      effect: read
      questions:
      - Which fields can I bulk edit across a set of issues?
      - Can I search the bulk-editable fields by name?
      instructions:
      - text: List the fields I can bulk edit on issues {issueIdsOrKeys}.
        slots:
          issueIdsOrKeys: query.issueIdsOrKeys
      - text: Find bulk-editable fields matching {searchText} for issues {issueIdsOrKeys}.
        slots:
          searchText: query.searchText
          issueIdsOrKeys: query.issueIdsOrKeys
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/fields'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit fields on many issues at once
      effect: write
      questions:
      - Can I change the same field on a batch of issues in one go?
      - What limits apply to the number of issues and fields in a bulk edit?
      instructions:
      - text: Bulk edit issues {selectedIssueIdsOrKeys}, applying actions {selectedActions} with values {editedFieldsInput}.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
          selectedActions: requestBody.selectedActions
          editedFieldsInput: requestBody.editedFieldsInput
      - text: Update fields {selectedActions} to {editedFieldsInput} on issues {selectedIssueIdsOrKeys}, sending bulk notification {sendBulkNotification}.
        slots:
          selectedActions: requestBody.selectedActions
          editedFieldsInput: requestBody.editedFieldsInput
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
          sendBulkNotification: requestBody.sendBulkNotification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/move'].post
  update:
    x-apievangelist-phrasing:
      intent: Move many issues to another project or type
      effect: write
      questions:
      - How do I move issues from several projects into one target project?
      - Can a bulk move change the issue type and parent at the same time?
      instructions:
      - text: Bulk move issues using the target-to-source mapping {targetToSourcesMapping}.
        slots:
          targetToSourcesMapping: requestBody.targetToSourcesMapping
      - text: Move issues per {targetToSourcesMapping} and set bulk notification to {sendBulkNotification}.
        slots:
          targetToSourcesMapping: requestBody.targetToSourcesMapping
          sendBulkNotification: requestBody.sendBulkNotification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/transition'].get
  update:
    x-apievangelist-phrasing:
      intent: List transitions available for bulk transitioning
      effect: read
      questions:
      - What status transitions can I apply to a group of issues together?
      - Which transition IDs are valid for a bulk transition of these issues?
      instructions:
      - text: List the bulk transitions available for issues {issueIdsOrKeys}.
        slots:
          issueIdsOrKeys: query.issueIdsOrKeys
      - text: Show the next page of available transitions for {issueIdsOrKeys} after {startingAfter}.
        slots:
          issueIdsOrKeys: query.issueIdsOrKeys
          startingAfter: query.startingAfter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/transition'].post
  update:
    x-apievangelist-phrasing:
      intent: Transition the status of many issues
      effect: write
      questions:
      - Can I move up to 1,000 issues to a new status in one request?
      - How do I close out a batch of issues with their transition IDs?
      instructions:
      - text: Bulk transition issues using {bulkTransitionInputs}.
        slots:
          bulkTransitionInputs: requestBody.bulkTransitionInputs
      - text: Apply transitions {bulkTransitionInputs} and send bulk notification {sendBulkNotification}.
        slots:
          bulkTransitionInputs: requestBody.bulkTransitionInputs
          sendBulkNotification: requestBody.sendBulkNotification
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/unwatch'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop watching many issues at once
      effect: write
      questions:
      - How do I unwatch a large batch of issues?
      - Is there a limit on how many issues I can unwatch in one request?
      instructions:
      - text: Unwatch issues {selectedIssueIdsOrKeys}.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
      - text: Stop me watching all of {selectedIssueIdsOrKeys} in bulk.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/issues/watch'].post
  update:
    x-apievangelist-phrasing:
      intent: Start watching many issues at once
      effect: write
      questions:
      - Can I watch up to 1,000 issues with one request?
      - What permission do I need to bulk watch issues?
      instructions:
      - text: Watch issues {selectedIssueIdsOrKeys}.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
      - text: Add me as a watcher on all of {selectedIssueIdsOrKeys} in bulk.
        slots:
          selectedIssueIdsOrKeys: requestBody.selectedIssueIdsOrKeys
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/bulk/queue/{taskId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check progress of a bulk issue operation
      effect: read
      questions:
      - How far along is my bulk edit or bulk delete?
      - Did my bulk issue task finish, and which issues failed?
      instructions:
      - text: Check the progress of bulk task {taskId}.
        slots:
          taskId: path.taskId
      - text: Tell me whether bulk operation {taskId} has completed.
        slots:
          taskId: path.taskId
      method: generated
      generated: '2026-09-26'