Atlassian The Confluence Cloud REST API — Content

naftiko: 1.0.0-alpha2
info:
  label: Atlassian The Confluence Cloud REST API — Content
  description: 'Atlassian The Confluence Cloud REST API — Content. 10 operations. Lead operation: Atlassian Get Content. Self-contained
    Naftiko capability covering one Atlassian business surface.'
  tags:
  - Atlassian
  - Content
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ATLASSIAN_API_KEY: ATLASSIAN_API_KEY
capability:
  consumes:
  - type: http
    namespace: confluence-content
    baseUri: ''
    description: Atlassian The Confluence Cloud REST API — Content business capability. Self-contained, no shared references.
    resources:
    - name: wiki-rest-api-content
      path: /wiki/rest/api/content
      operations:
      - name: atlassiangetcontent
        method: GET
        description: Atlassian Get Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: type
          in: query
          type: string
          description: 'The type of content to return. For example:'
        - name: spaceKey
          in: query
          type: string
          description: The key of the space to be queried for its content.
        - name: title
          in: query
          type: string
          description: The title of the page to be returned. Required for <code>page</code> type.
        - name: status
          in: query
          type: array
          description: Filter the results to a set of content based on their status. If set to `any`,
        - name: postingDay
          in: query
          type: string
          description: The posting date of the blog post to be returned. Required for
        - name: trigger
          in: query
          type: string
          description: If set to `viewed`, the request will trigger a 'viewed' event for the content.
        - name: orderby
          in: query
          type: string
          description: Orders the content by a particular field. Specify the field and sort direction for
        - name: start
          in: query
          type: integer
          description: The starting index of the returned content.
        - name: limit
          in: query
          type: integer
          description: The maximum number of content objects to return per page.
      - name: atlassiancreatecontent
        method: POST
        description: Atlassian Create Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: status
          in: query
          type: string
          description: Filter the returned content by status.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: wiki-rest-api-content-archive
      path: /wiki/rest/api/content/archive
      operations:
      - name: atlassianarchivepages
        method: POST
        description: Atlassian Archive Pages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: wiki-rest-api-content-blueprint-instance-draftId
      path: /wiki/rest/api/content/blueprint/instance/{draftId}
      operations:
      - name: atlassianpublishshareddraft
        method: PUT
        description: Atlassian Publish Shared Draft
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: draftId
          in: path
          type: string
          description: The ID of the draft page that was created from a blueprint.
          required: true
        - name: status
          in: query
          type: string
          description: The status of the content to be updated, i.e. the draft. This is set
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: atlassianpublishlegacydraft
        method: POST
        description: Atlassian Publish Legacy Draft
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: draftId
          in: path
          type: string
          description: The ID of the draft page that was created from a blueprint.
          required: true
        - name: status
          in: query
          type: string
          description: The status of the content to be updated, i.e. the draft. This is set
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: wiki-rest-api-content-search
      path: /wiki/rest/api/content/search
      operations:
      - name: atlassiansearchcontentbycql
        method: GET
        description: Atlassian Search Content By Cql
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: cql
          in: query
          type: string
          description: The CQL string that is used to find the requested content.
          required: true
        - name: cqlcontext
          in: query
          type: string
          description: The space, content, and content status to execute the search against.
        - name: cursor
          in: query
          type: string
          description: Pointer to a set of search results, returned as part of the `next` or `prev` URL from the previous
            search call.
        - name: limit
          in: query
          type: integer
          description: The maximum number of content objects to return per page.
    - name: wiki-rest-api-content-id
      path: /wiki/rest/api/content/{id}
      operations:
      - name: atlassiangetcontentbyid
        method: GET
        description: Atlassian Get Content By Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the content to be returned. If you don't know the content ID,
          required: true
        - name: status
          in: query
          type: array
          description: Filter the results to a set of content based on their status.
        - name: version
          in: query
          type: integer
          description: The version number of the content to be returned.
        - name: embeddedContentRender
          in: query
          type: string
          description: The version of embedded content (e.g. attachments) to render.
        - name: trigger
          in: query
          type: string
          description: If set to `viewed`, the request will trigger a 'viewed' event for the content.
      - name: atlassianupdatecontent
        method: PUT
        description: Atlassian Update Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the content to be updated.
          required: true
        - name: status
          in: query
          type: string
          description: The updated status of the content. Use this parameter to change the
        - name: conflictPolicy
          in: query
          type: string
          description: The action that should be taken when conflicts are discovered.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: atlassiandeletecontent
        method: DELETE
        description: Atlassian Delete Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the content to be deleted.
          required: true
        - name: status
          in: query
          type: string
          description: Set this to `trashed`, if the content's status is `trashed` and you want to purge it.
    - name: wiki-rest-api-content-id-history
      path: /wiki/rest/api/content/{id}/history
      operations:
      - name: atlassiangethistoryforcontent
        method: GET
        description: Atlassian Get Content History
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the content to be queried for its history.
          required: true
        - name: expand
          in: query
          type: array
          description: A multi-value parameter indicating which properties of the content history to expand.
    authentication:
      type: bearer
      token: '{{env.ATLASSIAN_API_KEY}}'
  exposes:
  - type: rest
    namespace: confluence-content-rest
    port: 8080
    description: REST adapter for Atlassian The Confluence Cloud REST API — Content. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/wiki/rest/api/content
      name: wiki-rest-api-content
      description: REST surface for wiki-rest-api-content.
      operations:
      - method: GET
        name: atlassiangetcontent
        description: Atlassian Get Content
        call: confluence-content.atlassiangetcontent
        with:
          type: rest.type
          spaceKey: rest.spaceKey
          title: rest.title
          status: rest.status
          postingDay: rest.postingDay
          trigger: rest.trigger
          orderby: rest.orderby
          start: rest.start
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassiancreatecontent
        description: Atlassian Create Content
        call: confluence-content.atlassiancreatecontent
        with:
          status: rest.status
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/wiki/rest/api/content/archive
      name: wiki-rest-api-content-archive
      description: REST surface for wiki-rest-api-content-archive.
      operations:
      - method: POST
        name: atlassianarchivepages
        description: Atlassian Archive Pages
        call: confluence-content.atlassianarchivepages
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/wiki/rest/api/content/blueprint/instance/{draftid}
      name: wiki-rest-api-content-blueprint-instance-draftid
      description: REST surface for wiki-rest-api-content-blueprint-instance-draftId.
      operations:
      - method: PUT
        name: atlassianpublishshareddraft
        description: Atlassian Publish Shared Draft
        call: confluence-content.atlassianpublishshareddraft
        with:
          draftId: rest.draftId
          status: rest.status
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: atlassianpublishlegacydraft
        description: Atlassian Publish Legacy Draft
        call: confluence-content.atlassianpublishlegacydraft
        with:
          draftId: rest.draftId
          status: rest.status
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/wiki/rest/api/content/search
      name: wiki-rest-api-content-search
      description: REST surface for wiki-rest-api-content-search.
      operations:
      - method: GET
        name: atlassiansearchcontentbycql
        description: Atlassian Search Content By Cql
        call: confluence-content.atlassiansearchcontentbycql
        with:
          cql: rest.cql
          cqlcontext: rest.cqlcontext
          cursor: rest.cursor
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/wiki/rest/api/content/{id}
      name: wiki-rest-api-content-id
      description: REST surface for wiki-rest-api-content-id.
      operations:
      - method: GET
        name: atlassiangetcontentbyid
        description: Atlassian Get Content By Id
        call: confluence-content.atlassiangetcontentbyid
        with:
          id: rest.id
          status: rest.status
          version: rest.version
          embeddedContentRender: rest.embeddedContentRender
          trigger: rest.trigger
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: atlassianupdatecontent
        description: Atlassian Update Content
        call: confluence-content.atlassianupdatecontent
        with:
          id: rest.id
          status: rest.status
          conflictPolicy: rest.conflictPolicy
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: atlassiandeletecontent
        description: Atlassian Delete Content
        call: confluence-content.atlassiandeletecontent
        with:
          id: rest.id
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/wiki/rest/api/content/{id}/history
      name: wiki-rest-api-content-id-history
      description: REST surface for wiki-rest-api-content-id-history.
      operations:
      - method: GET
        name: atlassiangethistoryforcontent
        description: Atlassian Get Content History
        call: confluence-content.atlassiangethistoryforcontent
        with:
          id: rest.id
          expand: rest.expand
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: confluence-content-mcp
    port: 9090
    transport: http
    description: MCP adapter for Atlassian The Confluence Cloud REST API — Content. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: atlassian-get-content
      description: Atlassian Get Content
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: confluence-content.atlassiangetcontent
      with:
        type: tools.type
        spaceKey: tools.spaceKey
        title: tools.title
        status: tools.status
        postingDay: tools.postingDay
        trigger: tools.trigger
        orderby: tools.orderby
        start: tools.start
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-create-content
      description: Atlassian Create Content
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: confluence-content.atlassiancreatecontent
      with:
        status: tools.status
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-archive-pages
      description: Atlassian Archive Pages
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: confluence-content.atlassianarchivepages
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-publish-shared-draft
      description: Atlassian Publish Shared Draft
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: confluence-content.atlassianpublishshareddraft
      with:
        draftId: tools.draftId
        status: tools.status
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-publish-legacy-draft
      description: Atlassian Publish Legacy Draft
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: confluence-content.atlassianpublishlegacydraft
      with:
        draftId: tools.draftId
        status: tools.status
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-search-content-cql
      description: Atlassian Search Content By Cql
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: confluence-content.atlassiansearchcontentbycql
      with:
        cql: tools.cql
        cqlcontext: tools.cqlcontext
        cursor: tools.cursor
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-content-id
      description: Atlassian Get Content By Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: confluence-content.atlassiangetcontentbyid
      with:
        id: tools.id
        status: tools.status
        version: tools.version
        embeddedContentRender: tools.embeddedContentRender
        trigger: tools.trigger
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-update-content
      description: Atlassian Update Content
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: confluence-content.atlassianupdatecontent
      with:
        id: tools.id
        status: tools.status
        conflictPolicy: tools.conflictPolicy
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-delete-content
      description: Atlassian Delete Content
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: confluence-content.atlassiandeletecontent
      with:
        id: tools.id
        status: tools.status
      outputParameters:
      - type: object
        mapping: $.
    - name: atlassian-get-content-history
      description: Atlassian Get Content History
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: confluence-content.atlassiangethistoryforcontent
      with:
        id: tools.id
        expand: tools.expand
      outputParameters:
      - type: object
        mapping: $.