openapi: 3.2.0
info:
  title: Confluence Cloud REST API v2 Classification Level API
  description: This document describes Confluence's v2 APIs. This is intended to be an iteration on the existing Confluence Cloud REST API with improvements in both endpoint definitions and performance.
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  version: 2.0.0
servers:
- url: https://{your-domain}/wiki/api/v2
  variables:
    your-domain:
      default: no-default
      description: Specific domain of the Confluence site being used. Must be provided.
tags:
- name: Classification Level
  description: ''
paths:
  /classification-levels:
    get:
      tags:
      - Classification Level
      operationId: getClassificationLevels
      summary: Get list of classification levels
      description: 'Returns a list of classification levels

        available.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission).'
      responses:
        '200':
          description: Returned if classifications levels are returned.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Classification levels do not exist

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permissions to access the Confluence site

            '
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:configuration:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:configuration:confluence
      x-atlassian-connect-scope: READ
  /spaces/{id}/classification-level/default:
    get:
      tags:
      - Classification Level
      operationId: getSpaceDefaultClassificationLevel
      summary: Get space default classification level
      description: 'Returns the default classification level

        for a specific space.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the space.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the space for which default classification level should be returned.
        schema:
          format: int64
          type: integer
      responses:
        '200':
          description: Returned if the requested default classification level for a space is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Default classification level is not applied to the space

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified space or the space was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:space:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:space:confluence
      x-atlassian-connect-scope: READ
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    put:
      tags:
      - Classification Level
      operationId: putSpaceDefaultClassificationLevel
      summary: Update space default classification level
      description: 'Update the default classification level

        for a specific space.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and ''Admin'' permission for the space.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the space for which default classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/SpaceDefaultClassificationLevelUpdateRequest'
      responses:
        '204':
          description: Returned if the default classification level was successfully updated.
          content: {}
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified space or the space was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:space:confluence
        - write:space:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:space:confluence
        - write:space:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    delete:
      tags:
      - Classification Level
      operationId: deleteSpaceDefaultClassificationLevel
      summary: Delete space default classification level
      description: 'Returns the default classification level

        for a specific space.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and ''Admin'' permission for the space.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the space for which default classification level should be deleted.
        schema:
          format: int64
          type: integer
      responses:
        '204':
          description: Returned if the default classification level was successfully deleted.
          content: {}
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified space or the space was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:space:confluence
        - write:space:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:space:confluence
        - write:space:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /pages/{id}/classification-level:
    get:
      tags:
      - Classification Level
      operationId: getPageClassificationLevel
      summary: Get page classification level
      description: 'Returns the classification level

        for a specific page.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the page.

        ''Permission to edit the page is required if trying to view classification level for a draft.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the page for which classification level should be returned.
        schema:
          format: int64
          type: integer
      - name: status
        in: query
        required: false
        description: Status of page from which classification level will fetched.
        schema:
          type: string
          default: current
          enum:
          - current
          - draft
          - archived
      responses:
        '200':
          description: Returned if the requested classification level for a page is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Page does not have a classification level applied

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified page or the page was not found

            - The calling user does not have permission to edit the specified page when trying to fetch classification level for a draft'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:page:confluence
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:page:confluence
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    put:
      tags:
      - Classification Level
      operationId: putPageClassificationLevel
      summary: Update page classification level
      description: 'Updates the classification level

        for a specific page.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to edit the page.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the page for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/ContentClassificationLevelUpdateRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully updated.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified page or the page was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /pages/{id}/classification-level/reset:
    post:
      tags:
      - Classification Level
      operationId: postPageClassificationLevel
      summary: Reset page classification level
      description: 'Resets the classification level

        for a specific page for the space

        default classification level.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the page.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the page for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/ContentClassificationLevelDeleteRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully reset.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified page or the page was not found'
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /blogposts/{id}/classification-level:
    get:
      tags:
      - Classification Level
      operationId: getBlogPostClassificationLevel
      summary: Get blog post classification level
      description: 'Returns the classification level

        for a specific blog post.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the blog post.

        ''Permission to edit the blog post is required if trying to view classification level for a draft.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the blog post for which classification level should be returned.
        schema:
          format: int64
          type: integer
      - name: status
        in: query
        required: false
        description: Status of blog post from which classification level will fetched.
        schema:
          type: string
          default: current
          enum:
          - current
          - draft
          - archived
      responses:
        '200':
          description: Returned if the requested classification level for a blog post is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Blog post does not have a classification level applied

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified blog post or the blog post was not found

            - The calling user does not have permission to edit the specified blog post when trying to fetch classification level for a draft'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:page:confluence
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:page:confluence
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    put:
      tags:
      - Classification Level
      operationId: putBlogPostClassificationLevel
      summary: Update blog post classification level
      description: 'Updates the classification level

        for a specific blog post.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to edit the blog post.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the blog post for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/ContentClassificationLevelUpdateRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully updated.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified blog post or the blog post was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /blogposts/{id}/classification-level/reset:
    post:
      tags:
      - Classification Level
      operationId: postBlogPostClassificationLevel
      summary: Reset blog post classification level
      description: 'Resets the classification level

        for a specific blog post for the space

        default classification level.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the blog post.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the blog post for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/ContentClassificationLevelDeleteRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully reset.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified blog post or the blog post was not found'
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:page:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:page:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /whiteboards/{id}/classification-level:
    get:
      tags:
      - Classification Level
      operationId: getWhiteboardClassificationLevel
      summary: Get whiteboard classification level
      description: 'Returns the classification level

        for a specific whiteboard.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the whiteboard.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the whiteboard for which classification level should be returned.
        schema:
          format: int64
          type: integer
      responses:
        '200':
          description: Returned if the requested classification level for a whiteboard is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Whiteboard does not have a classification level applied

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified whiteboard, or the whiteboard was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:whiteboard:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:whiteboard:confluence
      x-atlassian-connect-scope: READ
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    put:
      tags:
      - Classification Level
      operationId: putWhiteboardClassificationLevel
      summary: Update whiteboard classification level
      description: 'Updates the classification level

        for a specific whiteboard.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to edit the whiteboard.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the whiteboard for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/LiveEditContentClassificationLevelUpdateRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully updated.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified whiteboard

            - The whiteboard or classification level was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:whiteboard:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:whiteboard:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /whiteboards/{id}/classification-level/reset:
    post:
      tags:
      - Classification Level
      operationId: postWhiteboardClassificationLevel
      summary: Reset whiteboard classification level
      description: 'Resets the classification level

        for a specific whiteboard for the space

        default classification level.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the whiteboard.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the whiteboard for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/LiveEditContentClassificationLevelResetRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully reset.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified whiteboard, or the whiteboard was not found'
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:whiteboard:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:whiteboard:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /databases/{id}/classification-level:
    get:
      tags:
      - Classification Level
      operationId: getDatabaseClassificationLevel
      summary: Get database classification level
      description: 'Returns the classification level

        for a specific database.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the database.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the database for which classification level should be returned.
        schema:
          format: int64
          type: integer
      responses:
        '200':
          description: Returned if the requested classification level for a database is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClassificationLevel'
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Database does not have a classification level applied

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to view the specified database, or the database was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - read:database:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - read:database:confluence
      x-atlassian-connect-scope: READ
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
    put:
      tags:
      - Classification Level
      operationId: putDatabaseClassificationLevel
      summary: Update database classification level
      description: 'Updates the classification level

        for a specific database.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to edit the database.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the database for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/LiveEditContentClassificationLevelUpdateRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully updated.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified database

            - The database or the classification level was not found'
          content: {}
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:database:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:database:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
  /databases/{id}/classification-level/reset:
    post:
      tags:
      - Classification Level
      operationId: postDatabaseClassificationLevel
      summary: Reset database classification level
      description: 'Resets the classification level

        for a specific database for the space

        default classification level.


        **Permissions required**:

        ''Permission to access the Confluence site (''Can use'' global permission) and permission to view the database.'
      parameters:
      - name: id
        in: path
        required: true
        description: The ID of the database for which classification level should be updated.
        schema:
          format: int64
          type: integer
      requestBody:
        $ref: '#/components/requestBodies/LiveEditContentClassificationLevelResetRequest'
      responses:
        '204':
          description: Returned if the classification level was successfully reset.
        '400':
          description: Returned if an invalid request is provided.
          content: {}
        '401':
          description: 'Returned if the authentication credentials are incorrect or missing

            from the request.'
          content: {}
        '404':
          description: 'Returned if:

            - Site''s edition does not have entitlement(s) for [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/)

            - The calling user does not have permission to edit the specified database, or the database was not found'
      security:
      - basicAuth: []
      - oAuthDefinitions:
        - write:database:confluence
      x-atlassian-oauth2-scopes:
      - scheme: oAuthDefinitions
        state: Current
        scopes:
        - write:database:confluence
      x-atlassian-connect-scope: WRITE
      x-atlassian-data-security-policy:
      - app-access-rule-exempt: false
components:
  schemas:
    ClassificationLevelColor:
      type: string
      enum:
      - RED
      - RED_BOLD
      - ORANGE
      - YELLOW
      - GREEN
      - BLUE
      - NAVY
      - TEAL
      - PURPLE
      - GREY
      - LIME
    ClassificationLevelStatus:
      type: string
      enum:
      - DRAFT
      - PUBLISHED
      - ARCHIVED
    ClassificationLevel:
      title: ClassificationLevel
      type: object
      description: "A unit of [data classification](https://support.atlassian.com/security-and-access-policies/docs/what-is-data-classification/) defined by an organiation. \nA classification level may be associated with specific storage and handling requirements or expectations."
      properties:
        id:
          type: string
          description: The ID of the classification level.
        status:
          type: object
          description: The status of the classification level.
          $ref: '#/components/schemas/ClassificationLevelStatus'
        order:
          type: number
          description: The order of the classification level object.
        name:
          type: string
          description: The name of the classification level object.
        description:
          type: string
          description: The description of the classification level object.
        guideline:
          type: string
          description: The guideline of the classification level object.
        color:
          type: object
          description: The color of the classification level object.
          $ref: '#/components/schemas/ClassificationLevelColor'
  requestBodies:
    LiveEditContentClassificationLevelResetRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
            - status
            properties:
              status:
                enum:
                - current
                type: string
                description: Status of the content.
    SpaceDefaultClassificationLevelUpdateRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
            - id
            properties:
              id:
                type: string
                description: The ID of the classification level.
    ContentClassificationLevelUpdateRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
            - id
            - status
            properties:
              id:
                type: string
                description: The ID of the classification level.
              status:
                enum:
                - current
                - draft
                type: string
                description: Status of the content.
    LiveEditContentClassificationLevelUpdateRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
            - id
            - status
            properties:
              id:
                type: string
                description: The ID of the classification level.
              status:
                enum:
                - current
                type: string
                description: Status of the content.
    ContentClassificationLevelDeleteRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
            - status
            properties:
              status:
                enum:
                - current
                - draft
                type: string
                description: Status of the content.
  securitySchemes:
    basicAuth:
      type: http
      description: You can access this resource via basic auth.
      scheme: basic
    oAuthDefinitions:
      type: oauth2
      description: This API uses OAuth 2 with the authorizationCode grant flow.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.atlassian.com/authorize
          tokenUrl: https://auth.atlassian.com/oauth/token
          scopes:
            read:page:confluence: View pages and blogposts and their properties.
            read:space:confluence: View spaces and their properties.
            read:attachment:confluence: View attachments and their properties.
            read:comment:confluence: View comments and their properties.
            read:custom-content:confluence: View custom content and their properties.
            read:task:confluence: View tasks.
            read:whiteboard:confluence: View whiteboards and their properties.
            read:database:confluence: View databases and their properties.
            read:embed:confluence: View Smart Links in the content tree and their properties.
            read:folder:confluence: View folders and their properties.
            read:hierarchical-content:confluence: View children and descendants in the content tree.
            write:space:confluence: Create and update spaces and their properties.
            write:page:confluence: Create and update pages and blog posts and their properties.
            write:comment:confluence: Create and update comments and their properties.
            write:custom-content:confluence: Create and update custom content and their properties.
            write:whiteboard:confluence: Create and update whiteboards and their properties.
            write:database:confluence: Create and update databases and their properties.
            write:embed:confluence: Create and update Smart Links in the content tree and their properties.
            write:folder:confluence: Create and update folders and their properties.
            write:app-data:confluence: Create, update and delete app properties.
            delete:custom-content:confluence: Delete custom content.
            delete:page:confluence: Delete pages and blog posts.
            delete:comment:confluence: Delete comments.
            delete:whiteboard:confluence: Delete whiteboards.
            delete:database:confluence: Delete databases.
            delete:embed:confluence: Delete Smart Links in the content tree.
            delete:folder:confluence: Delete folders.
externalDocs:
  description: The online and complete version of the Confluence Cloud REST API docs.
  url: https://developer.atlassian.com/cloud/confluence/rest/v2
x-atlassian-narrative:
  documents:
  - title: About
    anchor: about
    body: This is the reference for the Confluence Cloud REST API v2, with definitions and performance intended to be an improvement over v1. You can click on the meatball menu in the upper right to download the spec or Postman collection.
  - title: Authentication and authorization
    anchor: auth
    body: '**Authentication:** If you are building a Cloud app, authentication is implemented via JWT or Oauth 2.0, depending on what you''re building (see [Authentication for apps](https://developer.atlassian.com/cloud/confluence/authentication-for-apps/)). Otherwise, if you are authenticating directly against the REST API, the REST API supports basic auth (see [Basic auth for REST APIs](https://developer.atlassian.com/cloud/confluence/basic-auth-for-rest-apis/)).


      **Authorization:** If you are building a Cloud app, authorization can be implemented by [scopes](https://developer.atlassian.com/cloud/confluence/scopes/) or by [OAuth 2.0 user impersonation](https://developer.atlassian.com/cloud/confluence/oauth-2-jwt-bearer-tokens-for-apps). Otherwise, if you are making calls directly against the REST API, authorization is based on the user used in the authentication process.


      See [Security overview](https://developer.atlassian.com/cloud/confluence/security-overview/) for more details on authentication and authorization.'
  - title: Using the REST API
    anchor: using
    body: "**Pagination:** The Confluence REST API v2 uses cursor-based pagination: a method that returns a response with multiple objects can only return a limited number at one time. This limits the size of responses and conserves server resources.\n\nUse the 'limit' and 'cursor' parameters on endpoints that return multiple objects to work with pagination. First, make a request with your desired limit in the 'limit' parameter, then observe the `Link` header in the response. If there are additional entities to be retrieved, the `next` URL in the `Link` header will allow you to retrieve the next set of results. This relative URL will also be available under the `_links.next` property of paginated responses. \n\nFor example, the following request will return 5 page objects (if there are 5 present in the target site).\n```\nGET /wiki/api/v2/pages?limit=5\n```\n\nIf there are additional pages available, the `Link` header will look like:\n```\n</wiki/api/v2/pages?limit=5&cursor=<cursor token>>; rel=\"next\"\n```\nThe URL within the `Link` header will allow you to access the next 5 pages, while the `rel=\"next\"` denotes that the URL refers to the \"next\" set of pages. Relations for a single URL are separated by semicolons (;) and URLs are separated by commas (,)\nIf there are no related URLs, the `Link` header will not be present in the response and neither will the `next` property for `_links` in the response body."