# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Atlassian The Jira Cloud platform REST Screen Tabs API
  version: 1.0.0
extends: openapi/atlassian-screen-tabs-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 6
- target: $.paths['/rest/api/3/screens/tabs'].get
  update:
    x-apievangelist-phrasing:
      intent: List tabs across many screens
      effect: read
      questions:
      - How do I get the tabs for a batch of Jira screens in one call?
      - Can I look up specific tabs by id across several screens?
      instructions:
      - text: List the tabs for screens {screenId}.
        slots:
          screenId: query.screenId
      - text: Get tabs {tabId} across screens {screenId}.
        slots:
          tabId: query.tabId
          screenId: query.screenId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/screens/{screenId}/tabs'].get
  update:
    x-apievangelist-phrasing:
      intent: List the tabs on one screen
      effect: read
      questions:
      - What tabs does a particular Jira screen have?
      - Can a project admin see a screen's tabs for their own project?
      instructions:
      - text: List tabs on screen {screenId}.
        slots:
          screenId: path.screenId
      - text: Show the tabs of screen {screenId} for project {projectKey}.
        slots:
          screenId: path.screenId
          projectKey: query.projectKey
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/screens/{screenId}/tabs'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a tab to a screen
      effect: write
      questions:
      - How do I add a new tab to a Jira screen?
      - What permission do I need to create a screen tab?
      instructions:
      - text: Add a tab named {name} to screen {screenId}.
        slots:
          name: requestBody.name
          screenId: path.screenId
      - text: Create tab {name} on screen {screenId}.
        slots:
          name: requestBody.name
          screenId: path.screenId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/screens/{screenId}/tabs/{tabId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a screen tab
      effect: write
      questions:
      - How do I rename an existing tab on a Jira screen?
      - Can I change only the name of a screen tab?
      instructions:
      - text: Rename tab {tabId} on screen {screenId} to {name}.
        slots:
          tabId: path.tabId
          screenId: path.screenId
          name: requestBody.name
      - text: Change the name of screen {screenId} tab {tabId} to {name}.
        slots:
          screenId: path.screenId
          tabId: path.tabId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/screens/{screenId}/tabs/{tabId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a screen tab
      effect: destructive
      questions:
      - How do I remove a tab from a Jira screen?
      - Who is allowed to delete a screen tab?
      instructions:
      - text: Delete tab {tabId} from screen {screenId}.
        slots:
          tabId: path.tabId
          screenId: path.screenId
      - text: Remove screen {screenId}'s tab {tabId}.
        slots:
          screenId: path.screenId
          tabId: path.tabId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rest/api/3/screens/{screenId}/tabs/{tabId}/move/{pos}'].post
  update:
    x-apievangelist-phrasing:
      intent: Reorder a tab on a screen
      effect: write
      questions:
      - How do I change the order of tabs on a Jira screen?
      - Can I move a screen tab to the first position?
      instructions:
      - text: Move tab {tabId} on screen {screenId} to position {pos}.
        slots:
          tabId: path.tabId
          screenId: path.screenId
          pos: path.pos
      - text: Reorder screen {screenId} so tab {tabId} sits at {pos}.
        slots:
          screenId: path.screenId
          tabId: path.tabId
          pos: path.pos
      method: generated
      generated: '2026-10-01'