# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Issue Priorities API
  version: 1.0.0
extends: openapi/jira-issue-priorities-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['/priority'].get
  update:
    x-apievangelist-phrasing:
      intent: List priorities via the root /priority path
      effect: read
      questions:
      - Is there a short root-level /priority endpoint that returns all issue priorities?
      - Can I fetch priorities from the unversioned priority path?
      instructions:
      - text: Get all issue priorities from the root-level /priority endpoint.
      - text: Call the unversioned priority path to list every priority.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority'].get
  update:
    x-apievangelist-phrasing:
      intent: List all priorities (deprecated v3 endpoint)
      effect: read
      questions:
      - How did the older, now-deprecated REST v3 call return every issue priority?
      - Which deprecated v3 endpoint lists all priorities in one unpaginated response?
      instructions:
      - text: List all priorities using the deprecated v3 get-priorities endpoint.
      - text: Fetch the complete unpaginated priority list from the legacy REST v3 call.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an issue priority
      effect: write
      questions:
      - How do I add a new priority level like Urgent to Jira?
      - What color format does a new priority need?
      - Can I still set an icon URL on a priority, or must I use an avatar?
      instructions:
      - text: Create a priority named {name} with color {statusColor}.
        slots:
          name: requestBody.name
          statusColor: requestBody.statusColor
      - text: Add priority {name} in color {statusColor} using avatar {avatarId}.
        slots:
          name: requestBody.name
          statusColor: requestBody.statusColor
          avatarId: requestBody.avatarId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the default issue priority
      effect: write
      questions:
      - How do I change which priority new issues get by default?
      - Can I clear the default priority altogether?
      instructions:
      - text: Make priority {id} the default for new issues.
        slots:
          id: requestBody.id
      - text: Set the site's default issue priority to {id}.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Reorder issue priorities
      effect: write
      questions:
      - How do I change the order priorities appear in?
      - Can I move priorities to the first or last position?
      instructions:
      - text: Move priorities {ids} to position {position}.
        slots:
          ids: requestBody.ids
          position: requestBody.position
      - text: Reorder priorities {ids} so they sit after priority {after}.
        slots:
          ids: requestBody.ids
          after: requestBody.after
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search priorities by name, project or ID
      effect: read
      questions:
      - Which priorities are available in a specific project?
      - Can I search priorities by name with paging?
      - How do I find out which priority is the default?
      instructions:
      - text: Search priorities named {priorityName}.
        slots:
          priorityName: query.priorityName
      - text: List priorities available in project {projectId}.
        slots:
          projectId: query.projectId
      - text: Show only the default priority ({onlyDefault}).
        slots:
          onlyDefault: query.onlyDefault
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one issue priority
      effect: read
      questions:
      - What are the name, color and description of a specific priority?
      - Can I look up a single priority by its ID?
      instructions:
      - text: Show priority {id}.
        slots:
          id: path.id
      - text: Get the details of issue priority {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an issue priority
      effect: write
      questions:
      - How do I rename or recolor an existing priority?
      - Can I change a priority's avatar after it's been created?
      instructions:
      - text: Rename priority {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Change the color of priority {id} to {statusColor}.
        slots:
          id: path.id
          statusColor: requestBody.statusColor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/priority/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an issue priority
      effect: destructive
      questions:
      - How do I remove a priority we no longer use?
      - Is deleting a priority an asynchronous task I have to track?
      instructions:
      - text: Delete priority {id}.
        slots:
          id: path.id
      - text: Remove issue priority {id} and give me the task to track.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'