Atlassian The Jira Cloud platform REST API — Permission Schemes

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Permission Schemes
  description: 'Atlassian The Jira Cloud platform REST API — Permission Schemes. 9 operations. Lead operation: Atlassian Get
    All Permission Schemes. Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Permission Schemes
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: jira-permission-schemes
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Permission Schemes business capability. Self-contained, no shared
      references.
    resources:
    - name: rest-api-3-permissionscheme
      path: /rest/api/3/permissionscheme
      operations:
      - name: atlassiangetallpermissionschemes
        method: GET
        description: Atlassian Get All Permission Schemes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are included when you specify
      - name: atlassiancreatepermissionscheme
        method: POST
        description: Atlassian Create Permission Scheme
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are always included when you '
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-permissionscheme-schemeId
      path: /rest/api/3/permissionscheme/{schemeId}
      operations:
      - name: atlassiandeletepermissionscheme
        method: DELETE
        description: Atlassian Delete Permission Scheme
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme being deleted.
          required: true
      - name: atlassiangetpermissionscheme
        method: GET
        description: Atlassian Get Permission Scheme
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme to return.
          required: true
        - name: expand
          in: query
          type: string
          description: Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are included when you specify
      - name: atlassianupdatepermissionscheme
        method: PUT
        description: Atlassian Update Permission Scheme
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme to update.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are always included when you '
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-permissionscheme-schemeId-permission
      path: /rest/api/3/permissionscheme/{schemeId}/permission
      operations:
      - name: atlassiangetpermissionschemegrants
        method: GET
        description: Atlassian Get Permission Scheme Grants
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are always included when you '
      - name: atlassiancreatepermissiongrant
        method: POST
        description: Atlassian Create Permission Grant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme in which to create a new permission grant.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are always included when you '
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-permissionscheme-schemeId-permission-permissionId
      path: /rest/api/3/permissionscheme/{schemeId}/permission/{permissionId}
      operations:
      - name: atlassiandeletepermissionschemeentity
        method: DELETE
        description: Atlassian Delete Permission Scheme Grant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme to delete the permission grant from.
          required: true
        - name: permissionId
          in: path
          type: integer
          description: The ID of the permission grant to delete.
          required: true
      - name: atlassiangetpermissionschemegrant
        method: GET
        description: Atlassian Get Permission Scheme Grant
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: schemeId
          in: path
          type: integer
          description: The ID of the permission scheme.
          required: true
        - name: permissionId
          in: path
          type: integer
          description: The ID of the permission grant.
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use expand to include additional information in the response. This parameter accepts a comma-separated
            list. Note that permissions are always included when you '
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-permission-schemes-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Permission Schemes. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/permissionscheme
      name: rest-api-3-permissionscheme
      description: REST surface for rest-api-3-permissionscheme.
      operations:
      - method: GET
        name: atlassiangetallpermissionschemes
        description: Atlassian Get All Permission Schemes
        call: jira-permission-schemes.atlassiangetallpermissionschemes
        with:
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreatepermissionscheme
        description: Atlassian Create Permission Scheme
        call: jira-permission-schemes.atlassiancreatepermissionscheme
        with:
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/permissionscheme/{schemeid}
      name: rest-api-3-permissionscheme-schemeid
      description: REST surface for rest-api-3-permissionscheme-schemeId.
      operations:
      - method: DELETE
        name: atlassiandeletepermissionscheme
        description: Atlassian Delete Permission Scheme
        call: jira-permission-schemes.atlassiandeletepermissionscheme
        with:
          schemeId: rest.schemeId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetpermissionscheme
        description: Atlassian Get Permission Scheme
        call: jira-permission-schemes.atlassiangetpermissionscheme
        with:
          schemeId: rest.schemeId
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdatepermissionscheme
        description: Atlassian Update Permission Scheme
        call: jira-permission-schemes.atlassianupdatepermissionscheme
        with:
          schemeId: rest.schemeId
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/permissionscheme/{schemeid}/permission
      name: rest-api-3-permissionscheme-schemeid-permission
      description: REST surface for rest-api-3-permissionscheme-schemeId-permission.
      operations:
      - method: GET
        name: atlassiangetpermissionschemegrants
        description: Atlassian Get Permission Scheme Grants
        call: jira-permission-schemes.atlassiangetpermissionschemegrants
        with:
          schemeId: rest.schemeId
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreatepermissiongrant
        description: Atlassian Create Permission Grant
        call: jira-permission-schemes.atlassiancreatepermissiongrant
        with:
          schemeId: rest.schemeId
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/permissionscheme/{schemeid}/permission/{permissionid}
      name: rest-api-3-permissionscheme-schemeid-permission-permissionid
      description: REST surface for rest-api-3-permissionscheme-schemeId-permission-permissionId.
      operations:
      - method: DELETE
        name: atlassiandeletepermissionschemeentity
        description: Atlassian Delete Permission Scheme Grant
        call: jira-permission-schemes.atlassiandeletepermissionschemeentity
        with:
          schemeId: rest.schemeId
          permissionId: rest.permissionId
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetpermissionschemegrant
        description: Atlassian Get Permission Scheme Grant
        call: jira-permission-schemes.atlassiangetpermissionschemegrant
        with:
          schemeId: rest.schemeId
          permissionId: rest.permissionId
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-permission-schemes-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Permission Schemes. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: atlassian-get-all-permission-schemes
      description: Atlassian Get All Permission Schemes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-permission-schemes.atlassiangetallpermissionschemes
      with:
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-permission-scheme
      description: Atlassian Create Permission Scheme
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-permission-schemes.atlassiancreatepermissionscheme
      with:
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-permission-scheme
      description: Atlassian Delete Permission Scheme
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-permission-schemes.atlassiandeletepermissionscheme
      with:
        schemeId: tools.schemeId
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-permission-scheme
      description: Atlassian Get Permission Scheme
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-permission-schemes.atlassiangetpermissionscheme
      with:
        schemeId: tools.schemeId
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-permission-scheme
      description: Atlassian Update Permission Scheme
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-permission-schemes.atlassianupdatepermissionscheme
      with:
        schemeId: tools.schemeId
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-permission-scheme-grants
      description: Atlassian Get Permission Scheme Grants
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-permission-schemes.atlassiangetpermissionschemegrants
      with:
        schemeId: tools.schemeId
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-permission-grant
      description: Atlassian Create Permission Grant
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-permission-schemes.atlassiancreatepermissiongrant
      with:
        schemeId: tools.schemeId
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-permission-scheme-grant
      description: Atlassian Delete Permission Scheme Grant
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-permission-schemes.atlassiandeletepermissionschemeentity
      with:
        schemeId: tools.schemeId
        permissionId: tools.permissionId
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-permission-scheme-grant
      description: Atlassian Get Permission Scheme Grant
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-permission-schemes.atlassiangetpermissionschemegrant
      with:
        schemeId: tools.schemeId
        permissionId: tools.permissionId
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.