Atlassian The Jira Cloud platform REST API — Screen Tabs

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Screen Tabs
  description: 'Atlassian The Jira Cloud platform REST API — Screen Tabs. 6 operations. Lead operation: Atlassian Get Bulk
    Screen Tabs. Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Screen Tabs
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: jira-screen-tabs
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Screen Tabs business capability. Self-contained, no shared references.
    resources:
    - name: rest-api-3-screens-tabs
      path: /rest/api/3/screens/tabs
      operations:
      - name: atlassiangetbulkscreentabs
        method: GET
        description: Atlassian Get Bulk Screen Tabs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: query
          type: array
          description: The list of screen IDs. To include multiple screen IDs, provide an ampersand-separated list. For example,
            `screenId=10000&screenId=10001`.
        - name: tabId
          in: query
          type: array
          description: The list of tab IDs. To include multiple tab IDs, provide an ampersand-separated list. For example,
            `tabId=10000&tabId=10001`.
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResult
          in: query
          type: integer
          description: The maximum number of items to return per page. The maximum number is 100,
    - name: rest-api-3-screens-screenId-tabs
      path: /rest/api/3/screens/{screenId}/tabs
      operations:
      - name: atlassiangetallscreentabs
        method: GET
        description: Atlassian Get All Screen Tabs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: path
          type: integer
          description: The ID of the screen.
          required: true
        - name: projectKey
          in: query
          type: string
          description: The key of the project.
      - name: atlassianaddscreentab
        method: POST
        description: Atlassian Create Screen Tab
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: path
          type: integer
          description: The ID of the screen.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-screens-screenId-tabs-tabId
      path: /rest/api/3/screens/{screenId}/tabs/{tabId}
      operations:
      - name: atlassiandeletescreentab
        method: DELETE
        description: Atlassian Delete Screen Tab
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: path
          type: integer
          description: The ID of the screen.
          required: true
        - name: tabId
          in: path
          type: integer
          description: The ID of the screen tab.
          required: true
      - name: atlassianrenamescreentab
        method: PUT
        description: Atlassian Update Screen Tab
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: path
          type: integer
          description: The ID of the screen.
          required: true
        - name: tabId
          in: path
          type: integer
          description: The ID of the screen tab.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-screens-screenId-tabs-tabId-move-pos
      path: /rest/api/3/screens/{screenId}/tabs/{tabId}/move/{pos}
      operations:
      - name: atlassianmovescreentab
        method: POST
        description: Atlassian Move Screen Tab
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: screenId
          in: path
          type: integer
          description: The ID of the screen.
          required: true
        - name: tabId
          in: path
          type: integer
          description: The ID of the screen tab.
          required: true
        - name: pos
          in: path
          type: integer
          description: The position of tab. The base index is 0.
          required: true
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-screen-tabs-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Screen Tabs. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/screens/tabs
      name: rest-api-3-screens-tabs
      description: REST surface for rest-api-3-screens-tabs.
      operations:
      - method: GET
        name: atlassiangetbulkscreentabs
        description: Atlassian Get Bulk Screen Tabs
        call: jira-screen-tabs.atlassiangetbulkscreentabs
        with:
          screenId: rest.screenId
          tabId: rest.tabId
          startAt: rest.startAt
          maxResult: rest.maxResult
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/screens/{screenid}/tabs
      name: rest-api-3-screens-screenid-tabs
      description: REST surface for rest-api-3-screens-screenId-tabs.
      operations:
      - method: GET
        name: atlassiangetallscreentabs
        description: Atlassian Get All Screen Tabs
        call: jira-screen-tabs.atlassiangetallscreentabs
        with:
          screenId: rest.screenId
          projectKey: rest.projectKey
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassianaddscreentab
        description: Atlassian Create Screen Tab
        call: jira-screen-tabs.atlassianaddscreentab
        with:
          screenId: rest.screenId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/screens/{screenid}/tabs/{tabid}
      name: rest-api-3-screens-screenid-tabs-tabid
      description: REST surface for rest-api-3-screens-screenId-tabs-tabId.
      operations:
      - method: DELETE
        name: atlassiandeletescreentab
        description: Atlassian Delete Screen Tab
        call: jira-screen-tabs.atlassiandeletescreentab
        with:
          screenId: rest.screenId
          tabId: rest.tabId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianrenamescreentab
        description: Atlassian Update Screen Tab
        call: jira-screen-tabs.atlassianrenamescreentab
        with:
          screenId: rest.screenId
          tabId: rest.tabId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/screens/{screenid}/tabs/{tabid}/move/{pos}
      name: rest-api-3-screens-screenid-tabs-tabid-move-pos
      description: REST surface for rest-api-3-screens-screenId-tabs-tabId-move-pos.
      operations:
      - method: POST
        name: atlassianmovescreentab
        description: Atlassian Move Screen Tab
        call: jira-screen-tabs.atlassianmovescreentab
        with:
          screenId: rest.screenId
          tabId: rest.tabId
          pos: rest.pos
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-screen-tabs-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Screen Tabs. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: atlassian-get-bulk-screen-tabs
      description: Atlassian Get Bulk Screen Tabs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-screen-tabs.atlassiangetbulkscreentabs
      with:
        screenId: tools.screenId
        tabId: tools.tabId
        startAt: tools.startAt
        maxResult: tools.maxResult
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-all-screen-tabs
      description: Atlassian Get All Screen Tabs
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-screen-tabs.atlassiangetallscreentabs
      with:
        screenId: tools.screenId
        projectKey: tools.projectKey
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-screen-tab
      description: Atlassian Create Screen Tab
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-screen-tabs.atlassianaddscreentab
      with:
        screenId: tools.screenId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-screen-tab
      description: Atlassian Delete Screen Tab
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-screen-tabs.atlassiandeletescreentab
      with:
        screenId: tools.screenId
        tabId: tools.tabId
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-screen-tab
      description: Atlassian Update Screen Tab
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-screen-tabs.atlassianrenamescreentab
      with:
        screenId: tools.screenId
        tabId: tools.tabId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-move-screen-tab
      description: Atlassian Move Screen Tab
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-screen-tabs.atlassianmovescreentab
      with:
        screenId: tools.screenId
        tabId: tools.tabId
        pos: tools.pos
      outputParameters:
      - type: object
        mapping: $.