Atlassian The Jira Cloud platform REST API — Projects

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Jira Cloud platform REST API — Projects
  description: 'Atlassian The Jira Cloud platform REST API — Projects. 13 operations. Lead operation: Atlassian Get All Projects.
    Self-contained Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Projects
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: jira-projects
    baseUri: https://your-domain.atlassian.net
    description: Atlassian The Jira Cloud platform REST API — Projects business capability. Self-contained, no shared references.
    resources:
    - name: rest-api-3-project
      path: /rest/api/3/project
      operations:
      - name: atlassiangetallprojects
        method: GET
        description: Atlassian Get All Projects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Expanded options include:'
        - name: recent
          in: query
          type: integer
          description: Returns the user's most recently accessed projects. You may specify the number of results to return
            up to a maximum of 20. If access is anonymous, then the rece
        - name: properties
          in: query
          type: array
          description: A list of project properties to return for the project. This parameter accepts a comma-separated list.
      - name: atlassiancreateproject
        method: POST
        description: Atlassian Create Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-project-recent
      path: /rest/api/3/project/recent
      operations:
      - name: atlassiangetrecent
        method: GET
        description: Atlassian Get Recent Projects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Expanded options include:'
        - name: properties
          in: query
          type: array
          description: EXPERIMENTAL. A list of project properties to return for the project. This parameter accepts a comma-separated
            list. Invalid property names are ignored.
    - name: rest-api-3-project-search
      path: /rest/api/3/project/search
      operations:
      - name: atlassiansearchprojects
        method: GET
        description: Atlassian Get Projects Paginated
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: startAt
          in: query
          type: integer
          description: The index of the first item to return in a page of results (page offset).
        - name: maxResults
          in: query
          type: integer
          description: The maximum number of items to return per page.
        - name: orderBy
          in: query
          type: string
          description: '[Order](#ordering) the results by a field.'
        - name: id
          in: query
          type: array
          description: The project IDs to filter the results by. To include multiple IDs, provide an ampersand-separated list.
            For example, `id=10000&id=10001`. Up to 50 project IDs c
        - name: keys
          in: query
          type: array
          description: 'The project keys to filter the results by. To include multiple keys, provide an ampersand-separated
            list. For example, `keys=PA&keys=PB`. Up to 50 project keys '
        - name: query
          in: query
          type: string
          description: Filter the results using a literal string. Projects with a matching `key` or `name` are returned (case
            insensitive).
        - name: typeKey
          in: query
          type: string
          description: 'Orders results by the [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes).
            This parameter accepts '
        - name: categoryId
          in: query
          type: integer
          description: The ID of the project's category. A complete list of category IDs is found using the [Get all project
            categories](#api-rest-api-3-projectCategory-get) operation
        - name: action
          in: query
          type: string
          description: 'Filter results by projects for which the user can:'
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Expanded options include:'
        - name: status
          in: query
          type: array
          description: 'EXPERIMENTAL. Filter results by project status:'
        - name: properties
          in: query
          type: array
          description: EXPERIMENTAL. A list of project properties to return for the project. This parameter accepts a comma-separated
            list.
        - name: propertyQuery
          in: query
          type: string
          description: EXPERIMENTAL. A query string used to search properties. The query string cannot be specified using
            a JSON object. For example, to search for the value of `neste
    - name: rest-api-3-project-projectIdOrKey
      path: /rest/api/3/project/{projectIdOrKey}
      operations:
      - name: atlassiandeleteproject
        method: DELETE
        description: Atlassian Delete Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
        - name: enableUndo
          in: query
          type: boolean
          description: Whether this project is placed in the Jira recycle bin where it will be available for restoration.
      - name: atlassiangetproject
        method: GET
        description: Atlassian Get Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
        - name: expand
          in: query
          type: string
          description: Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Note that the project description, is
        - name: properties
          in: query
          type: array
          description: A list of project properties to return for the project. This parameter accepts a comma-separated list.
      - name: atlassianupdateproject
        method: PUT
        description: Atlassian Update Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
        - name: expand
          in: query
          type: string
          description: Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Note that the project description, is
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: rest-api-3-project-projectIdOrKey-archive
      path: /rest/api/3/project/{projectIdOrKey}/archive
      operations:
      - name: atlassianarchiveproject
        method: POST
        description: Atlassian Archive Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
    - name: rest-api-3-project-projectIdOrKey-delete
      path: /rest/api/3/project/{projectIdOrKey}/delete
      operations:
      - name: atlassiandeleteprojectasynchronously
        method: POST
        description: Atlassian Delete Project Asynchronously
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
    - name: rest-api-3-project-projectIdOrKey-restore
      path: /rest/api/3/project/{projectIdOrKey}/restore
      operations:
      - name: atlassianrestore
        method: POST
        description: Atlassian Restore Deleted Or Archived Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
    - name: rest-api-3-project-projectIdOrKey-statuses
      path: /rest/api/3/project/{projectIdOrKey}/statuses
      operations:
      - name: atlassiangetallstatuses
        method: GET
        description: Atlassian Get All Statuses For Project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectIdOrKey
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
    - name: rest-api-3-project-projectId-hierarchy
      path: /rest/api/3/project/{projectId}/hierarchy
      operations:
      - name: atlassiangethierarchy
        method: GET
        description: Atlassian Get Project Issue Type Hierarchy
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectId
          in: path
          type: integer
          description: The ID of the project.
          required: true
    - name: rest-api-3-project-projectKeyOrId-notificationscheme
      path: /rest/api/3/project/{projectKeyOrId}/notificationscheme
      operations:
      - name: atlassiangetnotificationschemeforproject
        method: GET
        description: Atlassian Get Project Notification Scheme
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: projectKeyOrId
          in: path
          type: string
          description: The project ID or project key (case sensitive).
          required: true
        - name: expand
          in: query
          type: string
          description: 'Use [expand](#expansion) to include additional information in the response. This parameter accepts
            a comma-separated list. Expand options include:'
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: jira-projects-rest
    port: 8080
    description: REST adapter for Atlassian The Jira Cloud platform REST API — Projects. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/api/3/project
      name: rest-api-3-project
      description: REST surface for rest-api-3-project.
      operations:
      - method: GET
        name: atlassiangetallprojects
        description: Atlassian Get All Projects
        call: jira-projects.atlassiangetallprojects
        with:
          expand: rest.expand
          recent: rest.recent
          properties: rest.properties
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreateproject
        description: Atlassian Create Project
        call: jira-projects.atlassiancreateproject
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/recent
      name: rest-api-3-project-recent
      description: REST surface for rest-api-3-project-recent.
      operations:
      - method: GET
        name: atlassiangetrecent
        description: Atlassian Get Recent Projects
        call: jira-projects.atlassiangetrecent
        with:
          expand: rest.expand
          properties: rest.properties
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/search
      name: rest-api-3-project-search
      description: REST surface for rest-api-3-project-search.
      operations:
      - method: GET
        name: atlassiansearchprojects
        description: Atlassian Get Projects Paginated
        call: jira-projects.atlassiansearchprojects
        with:
          startAt: rest.startAt
          maxResults: rest.maxResults
          orderBy: rest.orderBy
          id: rest.id
          keys: rest.keys
          query: rest.query
          typeKey: rest.typeKey
          categoryId: rest.categoryId
          action: rest.action
          expand: rest.expand
          status: rest.status
          properties: rest.properties
          propertyQuery: rest.propertyQuery
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectidorkey}
      name: rest-api-3-project-projectidorkey
      description: REST surface for rest-api-3-project-projectIdOrKey.
      operations:
      - method: DELETE
        name: atlassiandeleteproject
        description: Atlassian Delete Project
        call: jira-projects.atlassiandeleteproject
        with:
          projectIdOrKey: rest.projectIdOrKey
          enableUndo: rest.enableUndo
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: atlassiangetproject
        description: Atlassian Get Project
        call: jira-projects.atlassiangetproject
        with:
          projectIdOrKey: rest.projectIdOrKey
          expand: rest.expand
          properties: rest.properties
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdateproject
        description: Atlassian Update Project
        call: jira-projects.atlassianupdateproject
        with:
          projectIdOrKey: rest.projectIdOrKey
          expand: rest.expand
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectidorkey}/archive
      name: rest-api-3-project-projectidorkey-archive
      description: REST surface for rest-api-3-project-projectIdOrKey-archive.
      operations:
      - method: POST
        name: atlassianarchiveproject
        description: Atlassian Archive Project
        call: jira-projects.atlassianarchiveproject
        with:
          projectIdOrKey: rest.projectIdOrKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectidorkey}/delete
      name: rest-api-3-project-projectidorkey-delete
      description: REST surface for rest-api-3-project-projectIdOrKey-delete.
      operations:
      - method: POST
        name: atlassiandeleteprojectasynchronously
        description: Atlassian Delete Project Asynchronously
        call: jira-projects.atlassiandeleteprojectasynchronously
        with:
          projectIdOrKey: rest.projectIdOrKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectidorkey}/restore
      name: rest-api-3-project-projectidorkey-restore
      description: REST surface for rest-api-3-project-projectIdOrKey-restore.
      operations:
      - method: POST
        name: atlassianrestore
        description: Atlassian Restore Deleted Or Archived Project
        call: jira-projects.atlassianrestore
        with:
          projectIdOrKey: rest.projectIdOrKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectidorkey}/statuses
      name: rest-api-3-project-projectidorkey-statuses
      description: REST surface for rest-api-3-project-projectIdOrKey-statuses.
      operations:
      - method: GET
        name: atlassiangetallstatuses
        description: Atlassian Get All Statuses For Project
        call: jira-projects.atlassiangetallstatuses
        with:
          projectIdOrKey: rest.projectIdOrKey
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectid}/hierarchy
      name: rest-api-3-project-projectid-hierarchy
      description: REST surface for rest-api-3-project-projectId-hierarchy.
      operations:
      - method: GET
        name: atlassiangethierarchy
        description: Atlassian Get Project Issue Type Hierarchy
        call: jira-projects.atlassiangethierarchy
        with:
          projectId: rest.projectId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/3/project/{projectkeyorid}/notificationscheme
      name: rest-api-3-project-projectkeyorid-notificationscheme
      description: REST surface for rest-api-3-project-projectKeyOrId-notificationscheme.
      operations:
      - method: GET
        name: atlassiangetnotificationschemeforproject
        description: Atlassian Get Project Notification Scheme
        call: jira-projects.atlassiangetnotificationschemeforproject
        with:
          projectKeyOrId: rest.projectKeyOrId
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: jira-projects-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Jira Cloud platform REST API — Projects. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: atlassian-get-all-projects
      description: Atlassian Get All Projects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangetallprojects
      with:
        expand: tools.expand
        recent: tools.recent
        properties: tools.properties
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-project
      description: Atlassian Create Project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-projects.atlassiancreateproject
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-recent-projects
      description: Atlassian Get Recent Projects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangetrecent
      with:
        expand: tools.expand
        properties: tools.properties
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-projects-paginated
      description: Atlassian Get Projects Paginated
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiansearchprojects
      with:
        startAt: tools.startAt
        maxResults: tools.maxResults
        orderBy: tools.orderBy
        id: tools.id
        keys: tools.keys
        query: tools.query
        typeKey: tools.typeKey
        categoryId: tools.categoryId
        action: tools.action
        expand: tools.expand
        status: tools.status
        properties: tools.properties
        propertyQuery: tools.propertyQuery
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-project
      description: Atlassian Delete Project
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: jira-projects.atlassiandeleteproject
      with:
        projectIdOrKey: tools.projectIdOrKey
        enableUndo: tools.enableUndo
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-project
      description: Atlassian Get Project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangetproject
      with:
        projectIdOrKey: tools.projectIdOrKey
        expand: tools.expand
        properties: tools.properties
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-project
      description: Atlassian Update Project
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: jira-projects.atlassianupdateproject
      with:
        projectIdOrKey: tools.projectIdOrKey
        expand: tools.expand
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-archive-project
      description: Atlassian Archive Project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-projects.atlassianarchiveproject
      with:
        projectIdOrKey: tools.projectIdOrKey
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-project-asynchronously
      description: Atlassian Delete Project Asynchronously
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-projects.atlassiandeleteprojectasynchronously
      with:
        projectIdOrKey: tools.projectIdOrKey
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-restore-deleted-archived-project
      description: Atlassian Restore Deleted Or Archived Project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: jira-projects.atlassianrestore
      with:
        projectIdOrKey: tools.projectIdOrKey
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-all-statuses-project
      description: Atlassian Get All Statuses For Project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangetallstatuses
      with:
        projectIdOrKey: tools.projectIdOrKey
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-project-issue-type
      description: Atlassian Get Project Issue Type Hierarchy
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangethierarchy
      with:
        projectId: tools.projectId
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-project-notification-scheme
      description: Atlassian Get Project Notification Scheme
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: jira-projects.atlassiangetnotificationschemeforproject
      with:
        projectKeyOrId: tools.projectKeyOrId
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.