# 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 resolutions API
  version: 1.0.0
extends: openapi/jira-issue-resolutions-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: 8
- target: $.paths['/rest/api/3/resolution'].get
  update:
    x-apievangelist-phrasing:
      intent: List all issue resolutions
      effect: read
      questions:
      - What resolution values are available for issues in my Jira?
      - Can I get every resolution without paging?
      instructions:
      - text: List every issue resolution.
      - text: Show all resolution values in one unpaged list.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an issue resolution
      effect: write
      questions:
      - How do I add a new resolution like 'Won't Do'?
      - Can I give a new resolution a description?
      instructions:
      - text: Create a resolution named {name}.
        slots:
          name: requestBody.name
      - text: Add resolution {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the default resolution
      effect: write
      questions:
      - How do I change which resolution is the default?
      - Can I make a particular resolution the default for resolved issues?
      instructions:
      - text: Make resolution {id} the default.
        slots:
          id: requestBody.id
      - text: Set the default issue resolution to {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Reorder issue resolutions
      effect: write
      questions:
      - How do I change the order resolutions appear in?
      - Can I move several resolutions to the top of the list?
      instructions:
      - text: Move resolutions {ids} after resolution {after}.
        slots:
          ids: requestBody.ids
          after: requestBody.after
      - text: Move resolutions {ids} to position {position}.
        slots:
          ids: requestBody.ids
          position: requestBody.position
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search resolutions with paging
      effect: read
      questions:
      - Can I page through resolutions or filter to specific IDs?
      - How do I find just the default resolution?
      instructions:
      - text: Search resolutions with IDs {id}.
        slots:
          id: query.id
      - text: Find resolutions where onlyDefault is {onlyDefault}.
        slots:
          onlyDefault: query.onlyDefault
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one issue resolution
      effect: read
      questions:
      - How do I look up a single resolution by ID?
      - What name and description does a given resolution have?
      instructions:
      - text: Show resolution {id}.
        slots:
          id: path.id
      - text: Get the details of resolution {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or redescribe a resolution
      effect: write
      questions:
      - How do I rename an existing resolution?
      - Can I update a resolution's description?
      instructions:
      - text: Rename resolution {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Update resolution {id} with name {name} and description {description}.
        slots:
          id: path.id
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/resolution/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resolution and reassign issues
      effect: destructive
      questions:
      - How do I delete a resolution that issues already use?
      - Is deleting a resolution asynchronous?
      instructions:
      - text: Delete resolution {id} and replace it with {replaceWith}.
        slots:
          id: path.id
          replaceWith: query.replaceWith
      - text: Remove resolution {id}, moving its issues to resolution {replaceWith}.
        slots:
          id: path.id
          replaceWith: query.replaceWith
      method: generated
      generated: '2026-09-26'