openapi: 3.1.0
info:
  title: Content Management API
  version: 1.0.0
paths:
  /spaces:
    get:
      operationId: getAllSpacesAnAccountHasAccessTo
      summary: Get all spaces an account has access to
      tags:
        - spaces
      parameters:
        - name: skip
          in: query
          description: Number of resources to skip (offset pagination).
          required: false
          schema:
            type: integer
        - name: limit
          in: query
          description: Maximum number of resources to return.
          required: false
          schema:
            type: integer
        - name: order
          in: query
          description: Sort order, e.g. `sys.createdAt` or `-sys.createdAt`.
          required: false
          schema:
            type: string
        - name: cursor
          in: query
          description: >-
            When `true`, switches the response to cursor-based pagination. The response includes a `pages` object with
            `next` and `prev` URLs instead of `skip`/`limit`.
          required: false
          schema:
            type: boolean
        - name: pageNext
          in: query
          description: Cursor token for the next page. Use the value from `pages.next` in a previous cursor-paginated response.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor token for the previous page. Use the value from `pages.prev` in a previous cursor-paginated response.
          required: false
          schema:
            type: string
        - name: query
          in: query
          description: Search spaces by exact space ID match or partial name match.
          required: false
          schema:
            type: string
        - name: type
          in: query
          description: Filter by space type.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Organization
          in: header
          description: >-
            Scope the listing to a specific organization. When omitted, spaces from all organizations the account has
            access to are returned.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createASpace
      summary: Create a space
      description: >-
        Create a new space, specifying attributes in the request body. You can optionally pass a `productId` to assign a
        specific product (from your organization's available licenses) to the new space.
      tags:
        - spaces
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Organization
          in: header
          description: Organization ID to create the space under
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}:
    get:
      operationId: getASpace
      summary: Get a space
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: include
          in: query
          description: >-
            Comma-separated list of related resources to include in the response. Supported value: `sys.license`
            (returns the space's license metadata in `includes.SpaceLicense`).
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateASpaceName
      summary: Update a space name
      description: >-
        Updates a space; send attributes as a JSON payload and include `X-Contentful-Version`.
        `X-Contentful-Organization` is optional if the account belongs to only one organization.
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Organization
          in: header
          description: Organization ID to create the space under
          required: false
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the space to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteASpace
      summary: Delete a space
      description: Deletes a space and all its resources — content types, entries, and assets. **This action cannot be undone.**
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/unarchive:
    post:
      operationId: unarchiveSpace
      summary: Unarchive a space
      description: >-
        Unarchive a space to make it active again. Pass a `productId` in the request body to assign a product license to
        the space upon unarchiving.
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the space to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                productId:
                  type: string
                  description: Product Id to assign to a space
  /spaces/{space_id}/space_add_ons:
    get:
      operationId: getSpaceAddOns
      summary: Get space add-ons from a space
      description: Get space add-ons from a specific space.
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: allocateSpaceAddOns
      summary: Allocate or deallocate space add-ons
      description: >-
        Sets the allocation of add-ons for a space. The value is the final amount (not a delta); partial resource
        subsets are accepted.
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: >-
                  #/components/schemas/SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItems
  /spaces/{space_id}/eligible_licenses:
    get:
      operationId: getEligibleLicenses
      summary: Get all eligible licenses
      description: >-
        Use this endpoint to list all eligible licenses for a given space under an organization. This will check if the
        space usage would fit into the licenses limits, and also check if entitlements bank can cover if shortage
        exists.
      tags:
        - spaces
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments:
    get:
      operationId: getAllEnvironmentsOfASpace
      summary: Get all environments of a space
      tags:
        - environments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnEnvironment
      summary: Create an environment
      description: >-
        Creates a new environment, optionally cloned from a source environment via `X-Contentful-Source-Environment`.
        Use a specified ID for automation — auto-generated IDs are not recommended.
      tags:
        - environments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Source-Environment
          in: header
          description: >-
            Environment ID for the desired source environment. You can create an environment with any other environment
            as a source by providing this header.
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}:
    get:
      operationId: getAnEnvironment
      summary: Get an environment
      tags:
        - environments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAnEnvironmentWithASpecifiedId
      summary: Create an environment with a specified ID
      description: >-
        Creates a new environment with the specified ID, or clones from a source environment via
        `X-Contentful-Source-Environment`. When updating an existing environment, include the current version in
        `X-Contentful-Version`.
      tags:
        - environments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Source-Environment
          in: header
          description: Environment ID for the desired source environment
          required: false
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the environment to update
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnEnvironment
      summary: Delete an environment
      tags:
        - environments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environment_aliases:
    get:
      operationId: getAllEnvironmentAliasesOfASpace
      summary: Get all environment aliases of a space
      tags:
        - environmentAliases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environment_aliases/{environment_alias_id}:
    get:
      operationId: getAnEnvironmentAlias
      summary: Get an environment alias
      tags:
        - environmentAliases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_alias_id
          in: path
          description: ID of the environment alias in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrUpdateAnEnvironmentAlias
      summary: Create or update an environment alias
      description: >-
        Creates a new environment alias or changes the environment it references. When updating, include the current
        alias version in `X-Contentful-Version`.
      tags:
        - environmentAliases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_alias_id
          in: path
          description: ID of the environment alias in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the environment alias to update
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnEnvironmentAlias
      summary: Delete an environment alias
      description: Deletes an environment alias. The `master` alias cannot be deleted.
      tags:
        - environmentAliases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_alias_id
          in: path
          description: ID of the environment alias in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations:
    get:
      operationId: getAllOrganizationsAnAccountHasAccessTo
      summary: Get all organizations an account has access to
      tags:
        - organizations
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}:
    get:
      operationId: getAnOrganizationIdAnAdminOrOwnerHasAccessTo
      summary: Get an organization id an admin or owner has access to
      tags:
        - organizations
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: putAnOrganizationIdAnAdminOrOwnerHasAccessTo
      summary: Put an organization id an admin or owner has access to
      tags:
        - organizations
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/space_add_ons:
    get:
      operationId: getOrganizationSpaceAddOns
      summary: Get space add-ons from an organization
      description: Get space add-ons from a specific organization.
      tags:
        - organizations
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/available_licenses:
    get:
      operationId: getAvailableLicenses
      summary: Get all available licenses
      description: >-
        Use this endpoint to list all the available licenses for an organization, the response is the counted and
        grouped licenses (by `product Id`).
      tags:
        - organizations
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/access_grant:
    get:
      operationId: getAnOrganizationAccessGrant
      summary: Get an organization access grant
      description: This endpoint allows you to verify whether the token has access permissions for this organization.
      tags:
        - organizations
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/security_contacts:
    get:
      operationId: getAnOrganizationSecurityContactsAnAdminOrOwnerHasAccessTo
      summary: Get an organization security contacts an admin or owner has access to
      tags:
        - securityContacts
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: postAnOrganizationSecurityContactsAnAdminOrOwnerHasAccessTo
      summary: Post an organization security contacts an admin or owner has access to
      tags:
        - securityContacts
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/security_contacts/{security_id}:
    put:
      operationId: updateAnOrganizationSecurityContactAnAdminOrOwnerHasAccessTo
      summary: Update an organization security contact an admin or owner has access to
      tags:
        - securityContacts
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: security_id
          in: path
          description: security_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnOrganizationSecurityContactAnAdminOrOwnerHasAccessTo
      summary: Delete an organization security contact an admin or owner has access to
      tags:
        - securityContacts
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: security_id
          in: path
          description: security_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/content_types:
    get:
      operationId: getAllContentTypesOfASpace
      summary: Get all content types of a space
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAContentTypeWithPost
      summary: Create a content type with POST
      description: >-
        Creates a content type with an auto-generated ID. Prefer the PUT method to control the content type ID, since
        IDs are often referenced in code.
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/content_types/{content_type_id}:
    get:
      operationId: getAContentType
      summary: Get a content type
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the Content Type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAContentTypeWithASpecifiedId
      summary: Create a content type with a specified ID
      description: >-
        Creates a new content type with the specified ID or updates an existing one. When updating, include the current
        version in `X-Contentful-Version`.
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the Content Type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the content type to update
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAContentType
      summary: Delete a content type
      description: _Before you can delete a content type you need to deactivate it_.
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the Content Type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/content_types/{content_type_id}/published:
    put:
      operationId: activateAContentType
      summary: Activate a content type
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the content type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the content type to activate
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deactivateAContentType
      summary: Deactivate a content type
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the content type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/public/content_types:
    get:
      operationId: getAllActivatedContentTypesOfASpace
      summary: Get all activated content types of a space
      description: Retrieves the activated versions of content types, ignoring any changes made since the last activation.
      tags:
        - contentTypes
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/ui_config:
    get:
      operationId: getTheUiConfig
      summary: Get the UI Config
      description: This endpoint returns the available UI Config in the current environment.
      tags:
        - uiConfig
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateTheUiConfig
      summary: Update the UI Config
      description: >-
        You can use this endpoint to update the UI Config in your environment. These settings are visible to everyone in
        the environment.
      tags:
        - uiConfig
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/ui_config/me:
    get:
      operationId: getTheUserUiConfig
      summary: Get the User UI Config
      tags:
        - uiConfig
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateTheUserUiConfig
      summary: Update the User UI Config
      description: You can use this endpoint to update your User UI Config.
      tags:
        - uiConfig
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/environment_templates:
    get:
      operationId: getAllEnvironmentTemplates
      summary: Get all environment templates
      description: >-
        This action returns a collection with all the environment templates in the organization repository. The
        templates are ordered by creation date descending.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnEnvironmentTemplate
      summary: Create an environment template
      description: >-
        This action creates an environment template in the organization repository. It implicitly creates a new version
        for this template.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/environment_templates/{template_id}:
    get:
      operationId: getAnEnvironmentTemplate
      summary: Get an environment template
      description: >-
        This action returns a specific environment template in the organization repository. The returned template is
        also the latest version in the **/versions** endpoint.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: installable
          in: query
          description: >-
            For templates of type forTemplatedSpaces only, filters the results to include only template versions that
            are installable based on the versions already installed.
          required: false
          schema:
            type: boolean
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnEnvironmentTemplate
      summary: Update an environment template
      description: >-
        Updates an environment template and implicitly creates a new version. Include `X-Contentful-Version` to lock
        against concurrent edits.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: >
            The ID of the organization. Alphanumerical.

            For more information about this parameter, see
            https://www.contentful.com/developers/docs/references/content-management-api/#/introduction/updating-and-version-locking.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the environment template to update
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnEnvironmentTemplate
      summary: Delete an environment template
      description: >-
        Deletes an environment template and all its versions. Entities previously installed from the template are not
        affected.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/environment_templates/{template_id}/versions:
    get:
      operationId: getAllVersionsOfAnEnvironmentTemplate
      summary: Get all versions of an environment template
      description: >-
        This action returns all the versions of an environment template. The versions are ordered by version number
        descending.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/environment_templates/{template_id}/versions/{version_number}:
    get:
      operationId: returnAVersionOfAnEnvironmentTemplate
      summary: Return a version of an environment template
      description: This action returns a certain version of an environment template.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: version_number
          in: path
          description: The version number of the template.
          required: true
          schema:
            type: number
            format: double
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/environment_templates/{template_id}/template_installations:
    get:
      operationId: getAllInstallationsOfAnEnvironmentTemplate
      summary: Get all installations of an environment template
      description: This action returns a collection with all installations of an environment template in the organization.
      tags:
        - contentModelTemplates
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization. Alphanumerical.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/template_installations/{template_id}:
    get:
      operationId: getAllInstallationsForATemplate
      summary: Get all installations for a template
      description: >-
        Returns all installation objects for a template in the environment, ordered by creation date descending. Each
        install or update attempt creates a new installation object.
      tags:
        - contentModelTemplates
      parameters:
        - name: space_id
          in: path
          description: The ID of the space. Alphanumerical.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/template_installations/{template_id}/versions:
    post:
      operationId: installATemplateInTheEnvironment
      summary: Install a template in the environment
      description: >-
        Installs a template version in the environment, creating a new installation object on success. Defaults to the
        latest version if no version is specified.
      tags:
        - contentModelTemplates
      parameters:
        - name: space_id
          in: path
          description: The ID of the space. Alphanumerical.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/template_installations/{template_id}/versions/{version_number}/validated:
    put:
      operationId: validateATemplateVersionForInstallation
      summary: Validate a template version for installation
      description: This action validates a template version for installation in the environment.
      tags:
        - contentModelTemplates
      parameters:
        - name: space_id
          in: path
          description: The ID of the space. Alphanumerical.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: version_number
          in: path
          description: The version number of the template.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/template_installations/{template_id}/validated:
    put:
      operationId: validateTheLatestTemplateVersionForInstallation
      summary: Validate the latest template version for installation
      description: This action validates the latest version of a template for installation in the environment.
      tags:
        - contentModelTemplates
      parameters:
        - name: space_id
          in: path
          description: The ID of the space. Alphanumerical.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment.
          required: true
          schema:
            type: string
        - name: template_id
          in: path
          description: The ID of the template. Alphanumerical.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/resource_provider:
    get:
      operationId: getAResourceProvider
      summary: Get a resource provider
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAResourceProvider
      summary: Create a resource provider
      description: >-
        Creates a resource provider for an app; each app can have only one. The `function.sys.id` in the request must
        match `functions[0].id` in the app's manifest.
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAResourceProvider
      summary: Delete a resource provider
      description: Deletes the resource provider for an app. Cannot be deleted if it has associated resource types.
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/resource_provider/resource_types/{resource_type_id}:
    get:
      operationId: getAResourceType
      summary: Get a resource type
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: resource_type_id
          in: path
          description: The ID of the resource type
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAResourceType
      summary: Create a resource type
      description: >-
        Creates or updates a resource type for an app's resource provider. Requires the app to have an associated
        resource provider — PUT fails without one.
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: resource_type_id
          in: path
          description: The ID of the resource type
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAResourceType
      summary: Delete a resource type
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: resource_type_id
          in: path
          description: The ID of the resource type
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/resource_provider/resource_types:
    get:
      operationId: getAllResourceTypes
      summary: Get all resource types
      tags:
        - nativeExternalReferences
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: The ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/resource_types:
    get:
      operationId: getAllResourceTypesInAnEnvironment
      summary: Get all resource types in an environment
      tags:
        - nativeExternalReferences
      parameters:
        - name: space_id
          in: path
          description: The ID of the space
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/resource_types/{resource_type_id}/resources:
    get:
      operationId: getAllResourcesInAnEnvironment
      summary: Get all resources in an environment
      tags:
        - nativeExternalReferences
      parameters:
        - name: space_id
          in: path
          description: The ID of the space
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: The ID of the environment
          required: true
          schema:
            type: string
        - name: resource_type_id
          in: path
          description: The ID of the resource type
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/enablements:
    get:
      operationId: getTheEnablementsForASpace
      summary: Get the enablements for a space
      description: >-
        Returns the enablement status of all features in a space. A default document (all features `false`) is created
        if none exists yet.
      tags:
        - spaceEnablements
      parameters:
        - name: space_id
          in: path
          description: The ID of the Space
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateTheEnablementsForASpace
      summary: Update the enablements for a space
      description: >-
        Enables or changes features for a space. Include `X-Contentful-Version` (use `1` if no document exists);
        `spaceTemplates` and `crossSpaceLinks` must always be set together.
      tags:
        - spaceEnablements
      parameters:
        - name: space_id
          in: path
          description: The ID of the Space
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Last version of the space enablement document you are updating
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/space_enablements:
    get:
      operationId: getAllEnablementsForAnOrganization
      summary: Get all enablements for an organization
      description: >-
        Returns enablement status for all features across all spaces in the organization. A default document (all
        features `false`) is created for any space that lacks one.
      tags:
        - spaceEnablements
      parameters:
        - name: organization_id
          in: path
          description: The ID of the Organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/enablements:
    get:
      operationId: getTheEnablementsForAnOrganization
      summary: Get the enablements for an organization
      description: >-
        Returns the enablement status of all features in an organization. A default document (all features `false`) is
        created if none exists yet.
      tags:
        - organizationEnablements
      parameters:
        - name: organization_id
          in: path
          description: The ID of the Organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateTheEnablementsForAnOrganization
      summary: Update the enablements for an organization
      description: >-
        Enables or changes features for an organization. Include `X-Contentful-Version` (use `1` if no document exists
        yet).
      tags:
        - organizationEnablements
      parameters:
        - name: organization_id
          in: path
          description: The ID of the Organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Last version of the organization enablement document you are updating
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/editor_interfaces:
    get:
      operationId: getAllEditorInterfacesOfASpace
      summary: Get all editor interfaces of a space
      tags:
        - editorInterface
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/content_types/{content_type_id}/editor_interface:
    get:
      operationId: getTheEditorInterface
      summary: Get the editor interface
      tags:
        - editorInterface
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the content type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateTheEditorInterface
      summary: Update the editor interface
      description: >-
        You can use this endpoint to update an existing editor interface. You will need to specify its last version with
        `X-Contentful-Version`.
      tags:
        - editorInterface
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the content type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the editor interface to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/extensions:
    get:
      operationId: getAllExtensionsOfASpace
      summary: Get all extensions of a space
      tags:
        - uiExtensions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnExtension
      summary: Create an extension
      tags:
        - uiExtensions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/extensions/{extension_id}:
    get:
      operationId: getAnExtension
      summary: Get an extension
      tags:
        - uiExtensions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: extension_id
          in: path
          description: ID of the extension in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrUpdateAnExtension
      summary: Create or update an extension
      description: >-
        Use this endpoint to create a new extension with a specified ID, or to update a specific extension via its ID.
        When updating an existing extension, you need to specify the last version of the extension you are updating with
        `X-Contentful-Version`.
      tags:
        - uiExtensions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: extension_id
          in: path
          description: ID of the extension in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the extension to update
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnExtension
      summary: Delete an extension
      tags:
        - uiExtensions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: extension_id
          in: path
          description: ID of the extension in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/entries:
    get:
      operationId: getAllEntriesOfASpace
      summary: Get all entries of a space
      description: >-
        To fetch specific entries like e.g. entries of a particular content type use [query search
        parameters](#/reference/search-parameters).
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnEntry
      summary: Create an entry
      description: >-
        Creates a new entry with an auto-generated ID; pass the desired content type in `X-Contentful-Content-Type`. New
        entries are created as drafts and must be published to appear on the CDA.
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Content-Type
          in: header
          description: The content type ID for the entry to create
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/public/entries:
    get:
      operationId: getAllPublishedEntriesOfASpace
      summary: Get all published entries of a space
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}:
    get:
      operationId: getAnEntry
      summary: Get an entry
      description: >-
        Returns an entry by ID. Empty fields are omitted from the response; include all keys that need to be updated
        when writing back.
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAnEntryWithASpecifiedId
      summary: Create an entry with a specified ID
      description: >-
        Creates a new entry with the specified ID or updates an existing one. Pass `X-Contentful-Content-Type` when
        creating; include `X-Contentful-Version` when updating.
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Content-Type
          in: header
          description: The content type ID for the entry to create
          required: false
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are updating
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnEntry
      summary: Delete an entry
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are updating
          required: false
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
    patch:
      operationId: patchAnEntry
      summary: Patch an entry
      description: >-
        Updates an entry using JSON Patch format. Include the current version in `X-Contentful-Version`; operations on
        unset fields require passing the full sub-object.
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are updating
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/references:
    get:
      operationId: getEntryReferences
      summary: Get entry references
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: include
          in: query
          description: Level of the entry descendants from 1 up to 10 maximum
          required: true
          schema:
            type: number
            format: double
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/published:
    put:
      operationId: publishAnEntry
      summary: Publish an entry
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are publishing
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unpublishAnEntry
      summary: Unpublish an entry
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are unpublishing
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/archived:
    put:
      operationId: archiveAnEntry
      summary: Archive an entry
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are archiving
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unarchiveAnEntry
      summary: Unarchive an entry
      tags:
        - entries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: The last version of the entry you are unarchiving
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/uploads:
    post:
      operationId: createAnUploadResource
      summary: Create an upload resource
      tags:
        - uploads
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space to retrieve.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        description: Binary file data
        content:
          application/octet-stream:
            schema:
              type: string
              format: binary
  /spaces/{space_id}/environments/{environment_id}/uploads/{upload_id}:
    get:
      operationId: retrieveAnUpload
      summary: Retrieve an upload
      tags:
        - uploads
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space to retrieve.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: false
          schema:
            type: string
        - name: upload_id
          in: path
          description: Alphanumeric `id` of the upload to retrieve.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnUpload
      summary: Delete an upload
      tags:
        - uploads
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: false
          schema:
            type: string
        - name: upload_id
          in: path
          description: Alphanumeric `id` of the upload to delete.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/bulk_operations/entries/create:
    post:
      operationId: createBulkOperation
      summary: Create bulk operation
      description: >-
        Creates a bulk operation from a previous upload, processing entries asynchronously. Omit `sys.id` for
        auto-generated IDs; existing IDs will fail with `EntryExistsError`.
      tags:
        - bulkEntryContentOperations
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Bulk operation created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '403':
          description: Forbidden - Bulk operations are not enabled for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '409':
          description: Conflict - A bulk operation is already in progress for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '422':
          description: Unprocessable Entity - Validation error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_operations/entries/export:
    post:
      operationId: createBulkOperationExport
      summary: Create bulk operation export
      description: >-
        Creates an async export operation for entries matching an optional `query` (max 10,000 entries). Poll the bulk
        operation endpoint until `sys.status` is `completed`, then download from `result.files`.
      tags:
        - bulkEntryContentOperations
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Bulk export operation created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '403':
          description: Forbidden - Bulk operations are not enabled for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '409':
          description: Conflict - A bulk operation is already in progress for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '422':
          description: Unprocessable Entity - Validation error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_operations:
    get:
      operationId: getAllBulkOperations
      summary: Get status of all bulk operations
      description: >-
        Retrieves bulk operations for the specified space and environment (cursor-paginated). Each item in `items`
        includes `sys` only (no `payload`, `result`, or `error`).
      tags:
        - bulkEntryContentOperations
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: true
          schema:
            type: string
        - name: sys.status[in]
          in: query
          description: 'Filter by status. Comma-separated list of statuses: `in_progress`, `failed`, `completed`.'
          required: false
          schema:
            type: string
        - name: sys.bulkType[in]
          in: query
          description: >-
            Filter by bulk operation type. Comma-separated list: `EntriesCreate`, `EntriesUpdate`, `EntriesDelete`,
            `EntriesExport`.
          required: false
          schema:
            type: string
        - name: sys.createdAt[gte]
          in: query
          description: Filter by creation date greater than or equal to the given ISO 8601 timestamp.
          required: false
          schema:
            type: string
        - name: sys.createdAt[lte]
          in: query
          description: Filter by creation date less than or equal to the given ISO 8601 timestamp.
          required: false
          schema:
            type: string
        - name: sys.updatedAt[gte]
          in: query
          description: Filter by update date greater than or equal to the given ISO 8601 timestamp.
          required: false
          schema:
            type: string
        - name: sys.updatedAt[lte]
          in: query
          description: Filter by update date less than or equal to the given ISO 8601 timestamp.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: >-
            Order results by `sys.createdAt`, `-sys.createdAt`, `sys.updatedAt`, or `-sys.updatedAt`. Defaults to
            `-sys.createdAt`.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of bulk operations to return. Minimum 1, maximum 100.
          required: false
          schema:
            type: number
            format: double
        - name: pageNext
          in: query
          description: Cursor for paginating forward. Mutually exclusive with `pagePrev`.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor for paginating backward. Mutually exclusive with `pageNext`.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '400':
          description: Bad Request - Invalid query parameter
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '403':
          description: Forbidden - Bulk operations are not enabled for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_operations/{bulk_operation_id}:
    get:
      operationId: getBulkOperation
      summary: Get status of a single bulk operation
      description: >-
        Returns the status of a bulk operation by ID. Check `sys.status` for state and `result.items` for per-entry
        outcomes; export jobs return `result.files` with signed ZIP URLs.
      tags:
        - bulkEntryContentOperations
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric `id` of the space.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: Alphanumeric `id` of the environment. Defaults to `master`.
          required: true
          schema:
            type: string
        - name: bulk_operation_id
          in: path
          description: Alphanumeric `id` of the bulk operation.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '403':
          description: Forbidden - Bulk operations are not enabled for this space
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/assets:
    get:
      operationId: getAllAssetsOfASpace
      summary: Get all assets of a space
      description: To fetch specific assets use [query search parameter](#/reference/search-parameters).
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAsset
      summary: Create an asset
      description: >-
        When using this endpoint, an ID will be automatically generated for the created asset and returned with the
        response.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/public/assets:
    get:
      operationId: getAllPublishedAssetsOfASpace
      summary: Get all published assets of a space
      description: Retrieves the published versions of all assets in a space.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/assets/{asset_id}:
    get:
      operationId: getAnAsset
      summary: Get an asset
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the Asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrUpdateAnAsset
      summary: Create or update an asset
      description: >-
        Creates a new asset with the specified ID or updates an existing one. When updating, include the current version
        in `X-Contentful-Version`.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the Asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to update
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnAsset
      summary: Delete an asset
      description: Deletes an asset and all previously referenced CDN files. CDN removal can take up to 48 hours.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the Asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to delete
          required: false
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/assets/{asset_id}/files/{locale_code}/process:
    put:
      operationId: processAnAsset
      summary: Process an asset
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: locale_code
          in: path
          description: Locale for which files should be processed
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to process
          required: false
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/assets/{asset_id}/published:
    put:
      operationId: publishAnAsset
      summary: Publish an asset
      description: >-
        Publishes an asset, making it available on the CDA and CDN. Image assets become accessible from
        `images.ctfassets.net` with Images API query parameter support.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to publish
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unpublishAnAsset
      summary: Unpublish an asset
      description: Unpublishing will put the asset back into draft state.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to unpublish
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/assets/{asset_id}/archived:
    put:
      operationId: archiveAnAsset
      summary: Archive an asset
      description: Archives an asset, removing it and its CDN files. CDN removal can take up to 48 hours.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the Asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to archive
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unarchiveAnAsset
      summary: Unarchive an asset
      description: >-
        Unarchives an asset, restoring it to draft state. Files can take up to an hour to become available on the CDN
        again.
      tags:
        - assets
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the Asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to unarchive
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/asset_keys:
    post:
      operationId: createAnAssetKey
      summary: Create an asset key
      description: >-
        Creates an asset key used to sign embargoed asset URLs for secure delivery. Specify an `expiresAt` Unix
        timestamp (maximum 48 hours ahead) to control key validity.
      tags:
        - assetKeys
      parameters:
        - name: space_id
          in: path
          description: Alphanumeric id of the space to retrieve.
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/locales:
    get:
      operationId: getAllLocalesOfASpace
      summary: Get all locales of a space
      description: >-
        The locales endpoint returns a list of all created locales. One will have the flag `default` set to true and is
        the locale used in the CDA, and you specified no other locale in the request.
      tags:
        - locales
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createALocale
      summary: Create a locale
      description: >-
        Use this endpoint to create a new locale for the specified space. You cannot create two locales with the same
        locale code.
      tags:
        - locales
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/locales/{locale_id}:
    get:
      operationId: getALocale
      summary: Get a locale
      description: This endpoint returns a single locale and its metadata.
      tags:
        - locales
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: locale_id
          in: path
          description: ID of the Locale in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateALocale
      summary: Update a locale
      description: >-
        Updates a locale in a space; include the current version in `X-Contentful-Version`. Changing a locale's `code`
        affects all future API responses and is not allowed on locales used as fallbacks.
      tags:
        - locales
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: locale_id
          in: path
          description: ID of the Locale in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the locale to update
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteALocale
      summary: Delete a locale
      description: >-
        Deletes a locale and all associated content. **This action cannot be undone.** Locales used as fallbacks by
        other locales cannot be deleted.
      tags:
        - locales
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: locale_id
          in: path
          description: ID of the Locale in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/taxonomy/concepts/{concept_id}:
    get:
      operationId: getAConcept
      summary: Get a concept
      tags:
        - taxonomy
      parameters:
        - name: concept_id
          in: path
          description: The ID of the concept.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAConceptWithUserDefinedId
      summary: Create a concept with user-defined ID
      description: Creates a single taxonomy concept with a user-defined ID.
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: concept_id
          in: path
          description: The user-defined ID of the concept.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAConcept
      summary: Delete a concept
      description: _Deleting concepts does not remove existing references to them in content type validations, or entries._
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
        - name: concept_id
          in: path
          required: true
          schema:
            type: string
        - name: concept_id
          in: query
          description: The ID of the concept.
          required: true
          schema:
            type: string
        - name: organization_id
          in: query
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the concept to update
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
    patch:
      operationId: updateAConcept
      summary: Update a concept
      description: >-
        Updates a taxonomy concept using JSON Patch format. Include the current version in `X-Contentful-Version`;
        operations on unset fields require passing the full sub-object rather than a nested path.
      tags:
        - taxonomy
      parameters:
        - name: concept_id
          in: path
          description: The ID of the concept.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the concept to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/taxonomy/concepts:
    get:
      operationId: getConcepts
      summary: Get concepts
      description: >-
        Returns all taxonomy concepts for an organization, with cursor-based pagination. Filter by `sys.id[in]`,
        `conceptScheme`, `order`, `limit`, `query`, `pageNext`, and `pagePrev` query parameters.
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: sys.id[in]
          in: query
          description: Return only the concepts matching the given comma-separated list of concept IDs
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: Limits the maximum number of concepts returned (per page).
          required: false
          schema:
            type: integer
        - name: pageNext
          in: query
          description: >-
            Pagination cursor from which to return the next page of concepts. Alternatively, just call the url at
            `pages.next` in the previous response.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: >-
            Pagination cursor from which to return the previous page of concepts. Alternatively, just use the full url
            from `pages.prev` in the previous response.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Options for ordering the results
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdTaxonomyConceptsGetParametersOrder'
        - name: conceptScheme
          in: query
          description: Return only concepts belonging to the specified concept scheme
          required: false
          schema:
            type: string
        - name: query
          in: query
          description: >-
            Filter results using a full-text search query, looking at _prefLabel_, _altLabels_, _hiddenLabels_ and
            _notations_ fields
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAConcept
      summary: Create a concept
      description: Create a single taxonomy concept.
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/taxonomy/concepts/{concept_id}/descendants:
    get:
      operationId: getDescendantsOfAConcept
      summary: Get descendants of a concept
      tags:
        - taxonomy
      parameters:
        - name: concept_id
          in: path
          description: The ID of the concept.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: depth
          in: query
          description: Number of levels to traverse downwards to retrieve descendants. *Default=1* (i.e. direct children only)
          required: false
          schema:
            type: integer
        - name: limit
          in: query
          description: Limits the maximum number of concepts returned (per page).
          required: false
          schema:
            type: integer
        - name: pageNext
          in: query
          description: >-
            Pagination cursor from which to return the next page of concepts. Alternatively, just call the url at
            `pages.next` in the previous response.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: >-
            Pagination cursor from which to return the previous page of concepts. Alternatively, just use the full url
            from `pages.prev` in the previous response.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Options for ordering the results
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdTaxonomyConceptsConceptIdDescendantsGetParametersOrder'
        - name: query
          in: query
          description: >-
            Filter results using a full-text search query, looking at _prefLabel_, _altLabels_, _hiddenLabels_ and
            _notations_ fields
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/taxonomy/concepts/{concept_id}/ancestors:
    get:
      operationId: getAncestorsOfAConcept
      summary: Get ancestors of a concept
      tags:
        - taxonomy
      parameters:
        - name: concept_id
          in: path
          description: The ID of the concept.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: depth
          in: query
          description: Number of levels to traverse upwards to retrieve ancestors. *Default=1* (i.e. direct parents only)
          required: false
          schema:
            type: integer
        - name: limit
          in: query
          description: Limits the maximum number of concepts returned (per page).
          required: false
          schema:
            type: integer
        - name: pageNext
          in: query
          description: >-
            Pagination cursor from which to return the next page of concepts. Alternatively, just call the url at
            `pages.next` in the previous response.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: >-
            Pagination cursor from which to return the previous page of concepts. Alternatively, just use the full url
            from `pages.prev` in the previous response.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Options for ordering the results
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdTaxonomyConceptsConceptIdAncestorsGetParametersOrder'
        - name: query
          in: query
          description: >-
            Filter results using a full-text search query, looking at _prefLabel_, _altLabels_, _hiddenLabels_ and
            _notations_ fields
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/taxonomy/concepts/total:
    get:
      operationId: getNumberOfConcepts
      summary: Get number of concepts
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/taxonomy/concept-schemes/{concept_scheme_id}:
    get:
      operationId: getAConceptScheme
      summary: Get a concept scheme
      tags:
        - taxonomy
      parameters:
        - name: concept_scheme_id
          in: path
          description: The ID of the concept scheme.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAConceptSchemeWithUserDefinedId
      summary: Create a concept scheme with user-defined ID
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: concept_scheme_id
          in: path
          description: The user-defined ID of the concept scheme.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAConceptScheme
      summary: Delete a concept scheme
      tags:
        - taxonomy
      parameters:
        - name: concept_scheme_id
          in: path
          description: The ID of the concept scheme.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the concept scheme to delete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
    patch:
      operationId: updateAConceptScheme
      summary: Update a concept scheme
      description: >-
        Updates a taxonomy concept scheme using JSON Patch format. Include the current version in
        `X-Contentful-Version`; operations on unset fields require passing the full sub-object rather than a nested
        path.
      tags:
        - taxonomy
      parameters:
        - name: concept_scheme_id
          in: path
          description: The ID of the concept scheme.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the concept scheme to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/taxonomy/concept-schemes:
    get:
      operationId: getConceptSchemes
      summary: Get concept schemes
      tags:
        - taxonomy
      parameters:
        - name: concept_scheme_id
          in: path
          description: The ID of the concept scheme.
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: limit
          in: query
          description: Limits the maximum number of concept schemes returned (per page).
          required: false
          schema:
            type: integer
        - name: pageNext
          in: query
          description: >-
            Pagination cursor from which to return the next page of concept schemes. Alternatively, just call the url at
            `pages.next` in the previous response.
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: >-
            Pagination cursor from which to return the previous page of concept schemes. Alternatively, just use the
            full url from `pages.prev` in the previous response.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Options for ordering the results
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdTaxonomyConceptSchemesGetParametersOrder'
        - name: query
          in: query
          description: Full-text search query, looking at _prefLabel_, _altLabels_, _hiddenLabels_ and _notations_ fields
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAConceptScheme
      summary: Create a concept scheme
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/taxonomy/concepts-schemes/total:
    get:
      operationId: getNumberOfConceptSchemes
      summary: Get number of concept schemes
      tags:
        - taxonomy
      parameters:
        - name: organization_id
          in: path
          description: The ID of the organization.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/tags:
    get:
      operationId: getAllTags
      summary: Get all tags
      description: Returns all the tags that exist in a given environment.
      tags:
        - tags
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/tags/{tag_id}:
    get:
      operationId: getATag
      summary: Get a tag
      description: Returns a single tag based on the given identifier.
      tags:
        - tags
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: tag_id
          in: path
          description: ID of the tag in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createATag
      summary: Create a tag
      description: >-
        Creates or updates a tag; tag IDs are immutable after creation. Set visibility via `X-Contentful-Tag-Visibility`
        header (defaults to `private`).
      tags:
        - tags
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: tag_id
          in: path
          description: ID of the tag in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Tag-Visibility
          in: header
          description: >-
            The tag visibility can be set in the header with this header. The visibility value set in the header
            overrides that in the payload.
          required: false
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the tag to update
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteATag
      summary: Delete a tag
      description: Deletes a tag from the entries and/or assets that reference it.
      tags:
        - tags
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: tag_id
          in: path
          description: ID of the tag in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the tag to delete
          required: false
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/ai/actions:
    get:
      operationId: getAllAiActions
      summary: Get all AI actions
      description: Returns all the AI Actions that exist in a given space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: status
          in: query
          description: Filter AI Actions by their publication status
          required: false
          schema:
            $ref: '#/components/schemas/SpacesSpaceIdAiActionsGetParametersStatus'
        - name: skip
          in: query
          description: The number of elements to skip before returning matching AI Actions.
          required: false
          schema:
            type: number
            format: double
        - name: limit
          in: query
          description: Limit the number of AI Actions being returned in the response.
          required: false
          schema:
            type: number
            format: double
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAiAction
      summary: Create an AI action
      description: Use this endpoint to create a new AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/ai/actions/{ai_action_id}:
    get:
      operationId: getAnAiAction
      summary: Get an AI action
      description: Use this endpoint to read an AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAiAction
      summary: Update AI Action
      description: Use this endpoint to update an AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the AI Action to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAiAction
      summary: Delete AI Action
      description: Use this endpoint to delete an AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the AI Action to delete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/ai/actions/{ai_action_id}/published:
    put:
      operationId: publishAnAiAction
      summary: Publish an AI action
      description: Use this endpoint to publish an AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the AI Action to publish
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unpublishAnAiAction
      summary: Unpublish an AI action
      description: Use this endpoint to unpublish an AI Action for a specified space.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/ai/actions/{ai_action_id}/invoke:
    post:
      operationId: invokeAnAiAction
      summary: Invoke an AI action
      description: Use this endpoint to invoke an AI Action for a specified space and environment.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/ai/actions/{ai_action_id}/invocations/{ai_action_invocation_id}:
    get:
      operationId: getAnAiActionInvocation
      summary: Get an AI action invocation
      description: >-
        Use this endpoint to obtain the result of an AI Action Invocation for a specified space, environment, AI Action
        and Invocation.
      tags:
        - aiActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in the form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in the form of a string
          required: true
          schema:
            type: string
        - name: ai_action_id
          in: path
          description: ID of the AI Action in form of a string
          required: true
          schema:
            type: string
        - name: ai_action_invocation_id
          in: path
          description: ID of the AI Action invocation in the form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/ai/providers:
    get:
      operationId: getAllAiProvidersForAnOrganization
      summary: Get all AI providers for an organization
      description: Returns all the AI Providers that exist in a given organization.
      tags:
        - aiProviders
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAiProvider
      summary: Create an AI provider
      description: Use this endpoint to create a new AI Provider of a specified type for an organization.
      tags:
        - aiProviders
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/ai/providers/{provider_id}:
    get:
      operationId: getAnAiProvider
      summary: Get an AI provider
      description: Use this endpoint to read an AI Provider for a specified organization.
      tags:
        - aiProviders
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: provider_id
          in: path
          description: ID of the AI provider
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnAiProvider
      summary: Delete an AI provider
      description: Use this endpoint to delete an AI Provider for a specified organization.
      tags:
        - aiProviders
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: provider_id
          in: path
          description: ID of the AI provider
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
    patch:
      operationId: updateAnAiProvider
      summary: Update an AI provider
      description: >-
        Use this endpoint to update a specific AI provider using [JSON Patch](http://jsonpatch.com/) format. This is
        useful for updating credentials, configuration, or selected models without replacing the entire provider
        configuration.
      tags:
        - aiProviders
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: provider_id
          in: path
          description: ID of the AI provider
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/automation_definitions:
    get:
      operationId: getAllAutomationDefinitions
      summary: Get all automation definitions
      tags:
        - automationDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: order
          in: query
          description: The order automation definitions should be sorted by (e.g., `sys.createdAt`, `-sys.createdAt`)
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: The number of automation definitions to return (default 100, max 100)
          required: false
          schema:
            type: integer
            default: 100
        - name: pageNext
          in: query
          description: Cursor for paginating forward
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor for paginating backward
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAutomationDefinition
      summary: Create an automation definition
      tags:
        - automationDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Automation definition created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/automation_definitions/{automation_definition_id}:
    get:
      operationId: getAutomationDefinition
      summary: Get automation definition
      tags:
        - automationDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: automation_definition_id
          in: path
          description: ID of the automation definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnAutomationDefinition
      summary: Update an automation definition
      tags:
        - automationDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: automation_definition_id
          in: path
          description: ID of the automation definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the automation definition to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnAutomationDefinition
      summary: Delete an automation definition
      tags:
        - automationDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: automation_definition_id
          in: path
          description: ID of the automation definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the automation definition to delete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/automation_executions:
    get:
      operationId: getAllAutomationExecutions
      summary: Get all automation executions
      tags:
        - automationExecutions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: sys.status[in]
          in: query
          description: >-
            Filter by status. Comma-separated list of statuses: `SCHEDULED`, `IN_PROGRESS`, `COMPLETED`, `FAILED`,
            `CANCELED`
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: The number of automation executions to return (default 100, max 100)
          required: false
          schema:
            type: integer
            default: 100
        - name: pageNext
          in: query
          description: Cursor for paginating forward
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor for paginating backward
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/automation_executions/{automation_execution_id}:
    get:
      operationId: getAutomationExecution
      summary: Get automation execution
      tags:
        - automationExecutions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: automation_execution_id
          in: path
          description: ID of the automation execution in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/automation_definitions/{automation_definition_id}/automation_executions:
    get:
      operationId: getExecutionsForAutomationDefinition
      summary: Get executions for automation definition
      tags:
        - automationExecutions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: automation_definition_id
          in: path
          description: ID of the automation definition in form of a string
          required: true
          schema:
            type: string
        - name: sys.status[in]
          in: query
          description: >-
            Filter by status. Comma-separated list of statuses: `SCHEDULED`, `IN_PROGRESS`, `COMPLETED`, `FAILED`,
            `CANCELED`
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: The order automation executions should be sorted by (e.g., `sys.createdAt`, `-sys.createdAt`)
          required: false
          schema:
            type: string
        - name: limit
          in: query
          description: The number of automation executions to return (default 100, max 100)
          required: false
          schema:
            type: integer
            default: 100
        - name: pageNext
          in: query
          description: Cursor for paginating forward
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor for paginating backward
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/webhook_definitions:
    get:
      operationId: getAllWebhooksOfASpace
      summary: Get all webhooks of a space
      tags:
        - webhooks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAWebhook
      summary: Create a webhook
      tags:
        - webhooks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/webhook_definitions/{webhook_definition_id}:
    get:
      operationId: getAWebhook
      summary: Get a webhook
      tags:
        - webhooks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: webhook_definition_id
          in: path
          description: ID of the webhook in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrUpdateAWebhook
      summary: Create or update a webhook
      tags:
        - webhooks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: webhook_definition_id
          in: path
          description: ID of the webhook in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAWebhook
      summary: Delete a webhook
      tags:
        - webhooks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: webhook_definition_id
          in: path
          description: ID of the webhook in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/webhooks/{webhook_id}/calls:
    get:
      operationId: getAnOverviewOfRecentCalls
      summary: Get an overview of recent calls
      tags:
        - webhookCalls
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: webhook_id
          in: path
          description: ID of the webhook in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/webhooks/{webhook_id}/calls/{call_id}:
    get:
      operationId: getTheWebhookCallDetails
      summary: Get the webhook call details
      tags:
        - webhookCalls
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: webhook_id
          in: path
          description: ID of the webhook in form of a string
          required: true
          schema:
            type: string
        - name: call_id
          in: path
          description: ID of the webhook call in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/webhooks/{webhook_id}/health:
    get:
      operationId: getWebhookHealth
      summary: Get webhook health
      tags:
        - webhookCalls
      parameters:
        - name: space_id
          in: path
          description: ID of the Space as a string
          required: true
          schema:
            type: string
        - name: webhook_id
          in: path
          description: ID of the Webhook as a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/webhook_settings/signing_secret:
    get:
      operationId: getAWebhookSigningSecret
      summary: Get a webhook signing secret
      tags:
        - webhookSecurity
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createAWebhookSigningSecret
      summary: Create a webhook signing secret
      tags:
        - webhookSecurity
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAWebhookSigningSecret
      summary: Delete a webhook signing secret
      tags:
        - webhookSecurity
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/roles:
    get:
      operationId: getAllRoles
      summary: Get all roles
      description: >-
        This endpoint returns a paginated list of roles for a given space. Each role contains a name, a description,
        permissions and policies, which describe what a user can and cannot do.
      tags:
        - roles
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createARole
      summary: Create a role
      description: Use this endpoint to create a custom role. The role name must be unique within the space.
      tags:
        - roles
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/roles/{role_id}:
    get:
      operationId: getARole
      summary: Get a role
      description: Use this endpoint to read an existing single role.
      tags:
        - roles
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: role_id
          in: path
          description: ID of the role in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateARole
      summary: Update a role
      description: >-
        Use this endpoint to update an existing role. You cannot use the endpoint to create a new role with a specific
        id.
      tags:
        - roles
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: role_id
          in: path
          description: ID of the role in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteARole
      summary: Delete a role
      description: >-
        Use this endpoint to delete an existing role. You can only delete roles if there is no user in the space with
        *only* that role assigned, i.e. a user must have at least one role.
      tags:
        - roles
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: role_id
          in: path
          description: ID of the role in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/snapshots:
    get:
      operationId: getAllSnapshotsOfAnEntry
      summary: Get all snapshots of an entry
      tags:
        - snapshots
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/snapshots/{snapshot_id}:
    get:
      operationId: getASnapshotOfAnEntry
      summary: Get a snapshot of an entry
      tags:
        - snapshots
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: snapshot_id
          in: path
          description: ID of the snapshot in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/content_types/{content_type_id}/snapshots:
    get:
      operationId: getAllSnapshotsOfAContentType
      summary: Get all snapshots of a content type
      tags:
        - snapshots
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the content type in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/content_types/{content_type_id}/snapshots/{snapshot_id}:
    get:
      operationId: getASnapshotOfAContentType
      summary: Get a snapshot of a content type
      tags:
        - snapshots
      parameters:
        - name: space_id
          in: path
          description: ID of the Space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: content_type_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: snapshot_id
          in: path
          description: ID of the snapshot in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/space_memberships:
    get:
      operationId: getAllSpaceMemberships
      summary: Get all space memberships
      description: This endpoint returns a paginated list of all space memberships.
      tags:
        - spaceMemberships
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createASpaceMembership
      summary: Create a space membership
      description: >-
        Use this endpoint to create a space membership (or invite a user to a space). A user can and must be flagged as
        'admin' or assigned to certain roles.
      tags:
        - spaceMemberships
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/space_memberships/{space_membership_id}:
    get:
      operationId: getASpaceMembership
      summary: Get a space membership
      description: This endpoint returns details about an existing space membership.
      tags:
        - spaceMemberships
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: space_membership_id
          in: path
          description: ID of the space membership in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateASpaceMembership
      summary: Update a space membership
      description: >-
        This endpoint allows you to change a space membership. Use this to assign additional roles or flag a user as
        'admin'.
      tags:
        - spaceMemberships
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: space_membership_id
          in: path
          description: ID of the space membership in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteASpaceMembership
      summary: Delete a space membership
      description: >-
        Deletes a space membership, revoking the user's space access without deleting their account. All admins can be
        removed, leaving the space unmanageable until a new admin is added.
      tags:
        - spaceMemberships
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: space_membership_id
          in: path
          description: ID of the space membership in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/teams:
    get:
      operationId: getAllTeamsForASpace
      summary: Get all teams for a space
      description: This endpoint returns a paginated list of all teams with access to a space.
      tags:
        - teams-for-a-space
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/api_keys:
    get:
      operationId: getAllDeliveryApiKeys
      summary: Get all Delivery API keys
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createADeliveryApiKey
      summary: Create a Delivery API key
      description: This endpoint allows you to create a Delivery API key and its corresponding Preview API key.
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/api_keys/{api_key_id}:
    get:
      operationId: getADeliveryApiKey
      summary: Get a Delivery API key
      description: This endpoint returns details about an existing Delivery API key.
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: api_key_id
          in: path
          description: ID of the Delivery API key in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateADeliveryApiKey
      summary: Update a Delivery API key
      description: >-
        Updates a Delivery API key and its corresponding Preview API key. Include the current version in
        `X-Contentful-Version`.
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: api_key_id
          in: path
          description: ID of the Delivery API key in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the API key to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteADeliveryApiKey
      summary: Delete a Delivery API key
      description: This endpoint allows you to delete a Delivery API key and its corresponding Preview API key.
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: api_key_id
          in: path
          description: ID of the Delivery API key in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/preview_api_keys:
    get:
      operationId: getAllPreviewApiKeys
      summary: Get all Preview API keys
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/preview_api_keys/{preview_api_key_id}:
    get:
      operationId: getAPreviewApiKey
      summary: Get a Preview API key
      description: This endpoint returns details about an existing Preview API key.
      tags:
        - apiKeys
      parameters:
        - name: space_id
          in: path
          description: ID of the space in a form of a string
          required: true
          schema:
            type: string
        - name: preview_api_key_id
          in: path
          description: preview_api_key_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /users/me/access_tokens:
    get:
      operationId: getAllAccessTokens
      summary: Get all access tokens
      description: >-
        Returns all CMA tokens (active and revoked) for the current user, across `PersonalAccessToken`, `CLIToken`, and
        `OAuthApplication` types. Filter by `sys.type`, `sys.expiresAt`, `sys.revokedAt`, `sys.createdAt`,
        `sys.lastUsedAt`, and `query`.
      tags:
        - accessTokens
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAccessToken
      summary: Create an access token
      description: >-
        Creates a Personal Access Token with the specified scopes (`content_management_read` or
        `content_management_manage`). The token value is only returned once — copy and store it securely.
      tags:
        - accessTokens
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /users/me/access_tokens/{token_id}:
    get:
      operationId: getAnAccessToken
      summary: Get an access token
      description: This endpoint returns details about an existing CMA token.
      tags:
        - accessTokens
      parameters:
        - name: token_id
          in: path
          description: ID of the personal access token in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /users/me/access_tokens/{token_id}/revoked:
    put:
      operationId: revokeAnAccessToken
      summary: Revoke an access token
      description: Revokes a CMA token, setting `revokedAt` to the current timestamp. **This action cannot be undone.**
      tags:
        - accessTokens
      parameters:
        - name: token_id
          in: path
          description: ID of the personal access token in a form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/access_tokens:
    get:
      operationId: getAllAccessTokensAdminView
      summary: Get all access tokens (admin view)
      description: >-
        Returns redacted CMA tokens for all members of the organization; accessible to admins and owners only. Supports
        the same date-range filters as the personal access tokens endpoint.
      tags:
        - accessTokens
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /users/{user_id}/oauth_applications:
    get:
      operationId: getAllOAuthApplications
      summary: Get all OAuth Applications
      description: This endpoint retrieves a list of OAuth applications associated with the current user.
      tags:
        - oauth-applications
      parameters:
        - name: user_id
          in: path
          description: ID of the user in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnOAuthApplication
      summary: Create an OAuth application
      description: This endpoint creates a new OAuth application.
      tags:
        - oauth-applications
      parameters:
        - name: user_id
          in: path
          description: ID of the user in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /users/{user_id}/oauth_applications/{oauth_application_id}:
    get:
      operationId: getAnOAuthApplication
      summary: Get an OAuth application
      description: This endpoint retrieves details of a specific OAuth application.
      tags:
        - oauth-applications
      parameters:
        - name: user_id
          in: path
          description: The ID of the user in string format.
          required: true
          schema:
            type: string
        - name: oauth_application_id
          in: path
          description: The ID of the OAuth Application in string format.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnOAuthApplication
      summary: Update an OAuth Application
      description: This endpoint updates details of a specific OAuth application.
      tags:
        - oauth-applications
      parameters:
        - name: user_id
          in: path
          description: The ID of the user in string format.
          required: true
          schema:
            type: string
        - name: oauth_application_id
          in: path
          description: The ID of the OAuth Application in string format.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnOAuthApplication
      summary: Delete an OAuth Application
      description: This endpoint deletes a specific OAuth application.
      tags:
        - oauth-applications
      parameters:
        - name: user_id
          in: path
          description: The ID of the user in string format.
          required: true
          schema:
            type: string
        - name: oauth_application_id
          in: path
          description: The ID of the OAuth Application in string format.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /users/me:
    get:
      operationId: getTheAuthenticatedUser
      summary: Get the authenticated user
      description: This endpoint returns details about your Contentful user account.
      tags:
        - users
      parameters:
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/semantic/search:
    post:
      operationId: runASemanticSearch
      summary: Run a semantic search
      description: This endpoint allows to perform a semantic search for a given query.
      tags:
        - contentSemantics
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/semantic/recommendations:
    post:
      operationId: getSemanticRecommendations
      summary: Get semantic recommendations
      description: This endpoint allows to semantically find similar entries based on the provided entry IDs.
      tags:
        - contentSemantics
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/semantic/duplicates:
    post:
      operationId: getSemanticDuplicates
      summary: Get semantic duplicates
      description: This endpoint detects potential duplicate entries based on semantic similarity.
      tags:
        - contentSemantics
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/semantic/reference-suggestions:
    post:
      operationId: getSemanticReferenceSuggestions
      summary: Get semantic reference suggestions
      description: This endpoint returns suggested entries that you can reference in a given field based on semantic relevance.
      tags:
        - contentSemantics
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/semantic/search-index:
    get:
      operationId: getAllSearchIndices
      summary: Get all search indices
      tags:
        - contentSemantics
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: status
          in: query
          description: 'Comma-separated list of index statuses to filter by. Possible values: `ACTIVE`, `PENDING`, `DELETING`.'
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createASearchIndex
      summary: Create a search index
      tags:
        - contentSemantics
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Search index created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/semantic/search-index/{index_id}:
    get:
      operationId: getASearchIndex
      summary: Get a search index
      tags:
        - contentSemantics
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: index_id
          in: path
          description: ID of the search index
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteASearchIndex
      summary: Delete a search index
      tags:
        - contentSemantics
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: index_id
          in: path
          description: ID of the search index
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/semantic/search-index:
    get:
      operationId: getAllEnvironmentSearchIndices
      summary: Get all environment search indices
      tags:
        - contentSemantics
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: status
          in: query
          description: 'Comma-separated list of index statuses to filter by. Possible values: `ACTIVE`, `PENDING`, `DELETING`.'
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/semantic/settings:
    get:
      operationId: getSemanticSettings
      summary: Get semantic settings
      tags:
        - contentSemantics
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/comments:
    get:
      operationId: getAllCommentsOfAnEntry
      summary: Get all comments of an entry
      description: >-
        Returns all comments on an entry (unpaginated). Filter by `status` query parameter; any user with read access
        can read comments.
      tags:
        - entryComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAComment
      summary: Create a comment
      description: >-
        Creates a comment on an entry with an auto-generated ID; limit is 100 comments per entry. Use
        `X-Contentful-Parent-Id` to reply to a specific comment.
      tags:
        - entryComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Parent-Id
          in: header
          description: Comment ID to reply to (creates a reply to the specified comment)
          required: false
          schema:
            type: string
        - name: X-Contentful-Parent-Entity-Reference
          in: header
          description: Reference to a specific field and locale of the entry (must match pattern fields.<field_id>.<locale_code>)
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/comments/{comment_id}:
    get:
      operationId: getAComment
      summary: Get a comment
      description: >-
        Returns an entry comment by ID. Any user with read access to the entry can read its comments; space admins can
        read comments in any entry.
      tags:
        - entryComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: comment_id
          in: path
          description: ID of the comment
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAComment
      summary: Update a comment
      description: Updates the body of an entry comment. Only the comment creator or a space admin can update a comment.
      tags:
        - entryComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: comment_id
          in: path
          description: ID of the comment
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the comment to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAComment
      summary: Delete a comment
      description: Deletes an entry comment. Comment creators and space admins can delete comments.
      tags:
        - entryComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: comment_id
          in: path
          description: ID of the comment
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the comment to delete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/workflows/{workflow_id}/comments:
    get:
      operationId: getAllCommentsOfAWorkflow
      summary: Get all comments of a workflow
      description: >-
        Returns all comments for a workflow. Filter by `status` query parameter; accessible to any user with read access
        to workflows.
      tags:
        - workflowComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/workflows/{workflow_id}/versions/{version}/comments:
    get:
      operationId: getAllCommentsOfASpecificWorkflowVersion
      summary: Get all comments of a specific workflow version
      description: Returns all comments for a specific workflow version. Accessible to any user with read access to workflows.
      tags:
        - workflowComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: version
          in: path
          description: Version number of the workflow in form of a string
          required: true
          schema:
            type: integer
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAWorkflowComment
      summary: Create a workflow comment
      description: >-
        Creates a comment for a specific workflow version; only one comment per version is supported. Accessible to any
        user with read access to workflows.
      tags:
        - workflowComments
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: version
          in: path
          description: Version number of the workflow
          required: true
          schema:
            type: integer
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/tasks:
    get:
      operationId: getAllTasksThatAreAssignedToYou
      summary: Get all tasks that are assigned to you
      description: Returns paginated tasks assigned to you. Requires `filter=myPendingTasks` query parameter.
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: filter
          in: query
          description: >-
            This endpoint expects the query parameter `filter=myPendingTasks`. A call without this parameter will return
            a `501` status code.
          required: true
          schema:
            $ref: '#/components/schemas/SpacesSpaceIdEnvironmentsEnvironmentIdTasksGetParametersFilter'
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/tasks:
    get:
      operationId: getAllTasksOfAnEntry
      summary: Get all tasks of an entry
      description: >-
        Returns a paginated list of tasks for an entry. Any user with read access to the entry can read its tasks; space
        admins can read tasks in any entry.
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: |
            ID of the entry in form of a
            string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createATask
      summary: Create a task
      description: >-
        Creates a task on an entry with an auto-generated ID; limit is 100 tasks per entry. Email notifications are sent
        to the assignee (and team members if assigned to a team).
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: |
            ID of the entry in form of a
            string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/entries/{entry_id}/tasks/{task_id}:
    get:
      operationId: getATask
      summary: Get a task
      description: >-
        Returns an entry task by ID. Any user with read access to the entry can read its tasks; space admins can read
        tasks in any entry.
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: task_id
          in: path
          description: ID of the task
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateATask
      summary: Update a task
      description: >-
        Updates a task's body, assignee, or status. Task assignees can only update `status`; task creators and admins
        can update `body` and `assignedTo`. Resolved tasks cannot have `body` or `assignee` changed without unresolving
        first.
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: task_id
          in: path
          description: ID of the task
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the task to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteATask
      summary: Delete a task
      description: Deletes a task. Task creators and space admins can delete tasks.
      tags:
        - entryTasks
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: task_id
          in: path
          description: ID of the task
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the task to delete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/scheduled_actions:
    get:
      operationId: getAllScheduledActionsOfAnEntry
      summary: Get all scheduled actions of an entry
      description: >-
        Returns scheduled actions for the space, cursor-paginated (default page 100, max 1000). Filter by
        `environment.sys.id` (required), `entity.sys.id`, `sys.status`, and `scheduledFor.datetime`.
      tags:
        - scheduledActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: entity.sys.id
          in: query
          description: ID of the entry in form of a string
          required: false
          schema:
            type: string
        - name: environment.sys.id
          in: query
          description: ID of the environment in form of a string
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAScheduledAction
      summary: Create a scheduled action
      description: >-
        Creates a scheduled action with an auto-generated ID. Limit is 200 pending scheduled actions per environment;
        `scheduledFor.datetime` must be a future ISO 8601 timestamp.
      tags:
        - scheduledActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/scheduled_actions/{scheduled_action_id}:
    get:
      operationId: getAScheduledAction
      summary: Get a scheduled action
      description: Returns a single scheduled action by ID.
      tags:
        - scheduledActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: scheduled_action_id
          in: path
          description: ID of the scheduled action in form of a string
          required: true
          schema:
            type: string
        - name: environment.sys.id
          in: query
          description: ID of the environment in form of a string
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAScheduledAction
      summary: Update a scheduled action
      description: >-
        Updates the `scheduledFor.datetime` or `scheduledFor.timezone` of a scheduled action. Only fields under
        `scheduledFor` can be changed; include `X-Contentful-Version`.
      tags:
        - scheduledActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: scheduled_action_id
          in: path
          description: ID of the scheduled action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the scheduled action to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: cancelAScheduledAction
      summary: Cancel a scheduled action
      description: Cancels a scheduled action. Only actions in `scheduled` status can be cancelled.
      tags:
        - scheduledActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: scheduled_action_id
          in: path
          description: ID of the scheduled action in form of a string
          required: true
          schema:
            type: string
        - name: environment.sys.id
          in: query
          description: ID of the environment in form of a string
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases:
    get:
      operationId: getAllReleases
      summary: Get all releases
      description: >-
        Returns releases for the environment, cursor-paginated. Filter by ID, creator, status, entity membership, and
        `title[match]`.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: sys.schemaVersion
          in: query
          description: Schema version to filter releases. Use 'Release.v2' for timeline releases format.
          required: false
          schema:
            $ref: '#/components/schemas/SpacesSpaceIdEnvironmentsEnvironmentIdReleasesGetParametersSysSchemaVersion'
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createARelease
      summary: Create a release
      description: >-
        Creates a new release with an auto-generated ID.


        Use the `entities.items[]` shape that matches the release version and the space's publishing mode:


        * `Release.v1`: direct Entry or Asset links.

        * `Release.v2` with entry-based publishing: `entity` plus `action`, where `action` is `publish` or `unpublish`.

        * `Release.v2` with locale-based publishing: `entity` plus `add` and `remove`.


        Only locale-based publishing uses `add` and `remove`. In that mode, each entity item must include both
        properties, and every environment locale must appear exactly once across `add.fields["*"]` and
        `remove.fields["*"]`.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}:
    get:
      operationId: getARelease
      summary: Get a release
      description: Returns a single release by ID.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateARelease
      summary: Update a release
      description: Updates a release by ID. Include `X-Contentful-Version`.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteARelease
      summary: Delete a release
      description: Deletes a release by ID. Only the release creator or an admin can delete a release.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/validate:
    post:
      operationId: createAValidationReleaseAction
      summary: Create a validation release action
      description: >-
        Asynchronously validates a release for publishing or unpublishing. Only one validation at a time is allowed per
        release.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/published:
    put:
      operationId: publishARelease
      summary: Publish a release
      description: Publishes all entities in a release. The release is automatically archived on success.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '202':
          description: HTTP 202
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unpublishARelease
      summary: Unpublish a release
      description: Unpublishes all entities in a release.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '202':
          description: HTTP 202
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/archived:
    put:
      operationId: archiveARelease
      summary: Archive a release
      description: Archives a release, preventing publish, unpublish, or scheduling actions. Include `X-Contentful-Version`.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the release to archive
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: unarchiveARelease
      summary: Unarchive a release
      description: >-
        Unarchives a release, re-enabling publish, unpublish, and scheduling actions. Include `X-Contentful-Version`.
        Not supported for Timeline releases (`sys.schemaVersion` `Release.v2`), which return a 400 error.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the release to unarchive
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/release_actions:
    get:
      operationId: getAllReleaseActions
      summary: Get all release actions
      description: >-
        Returns release actions across one or more releases. Filter by action type (`validate`, `publish`, `unpublish`),
        status, and release ID.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/actions/{release_action_id}:
    get:
      operationId: getAReleaseAction
      summary: Get a release action
      description: >-
        Returns a single release action by ID. Accessible to any user with read access to entries; returns 404 if the
        release or action is not found.
      tags:
        - releases
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: release_action_id
          in: path
          description: ID of the release action in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/entries:
    get:
      operationId: getAllEntriesOfARelease
      summary: Get all entries of a release
      description: >-
        To fetch specific entries like e.g. entries of a particular content type use [query search
        parameters](#/reference/search-parameters).
      tags:
        - timelineEntries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnEntryInARelease
      summary: Create an entry in a release
      description: Use this endpoint to create a new entry and add it to the release in one step.
      tags:
        - timelineEntries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/entries/{entry_id}:
    get:
      operationId: getAnEntryInARelease
      summary: Get an entry in a release
      description: >-
        Returns a release entry by ID. Empty fields are omitted from the response; include them explicitly when updating
        to set empty values.
      tags:
        - timelineEntries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnEntry
      summary: Update an entry
      description: >-
        Updates a release entry by ID. Include the current version in `X-Contentful-Version`; content type ID is not
        required in the payload.
      tags:
        - timelineEntries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the entry to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    patch:
      operationId: patchAnEntryInARelease
      summary: Patch an entry in a release
      description: >-
        Updates a release entry using JSON Patch format. Include the current version in `X-Contentful-Version`;
        operations on unset fields require passing the full sub-object.
      tags:
        - timelineEntries
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: entry_id
          in: path
          description: ID of the entry in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the entry to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/assets:
    get:
      operationId: getAllAssetsOfARelease
      summary: Get all assets of a release
      description: To fetch specific assets use [query search parameters](#/reference/search-parameters).
      tags:
        - timelineAssets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAssetInARelease
      summary: Create an asset in a release
      description: >-
        Creates a new asset and adds it to the release in one step. An ID is auto-generated and returned with the
        response.
      tags:
        - timelineAssets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/assets/{asset_id}:
    get:
      operationId: getAnAssetInARelease
      summary: Get an asset in a release
      tags:
        - timelineAssets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnAsset
      summary: Update an asset
      description: >-
        Creates a new asset with the specified ID or updates an existing one within the release. Include the current
        version in `X-Contentful-Version` when updating.
      tags:
        - timelineAssets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to update
          required: false
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/releases/{release_id}/assets/{asset_id}/files/{locale_code}/process:
    put:
      operationId: processAnAssetInARelease
      summary: Process an asset in a release
      tags:
        - timelineAssets
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: release_id
          in: path
          description: ID of the release in form of a string
          required: true
          schema:
            type: string
        - name: asset_id
          in: path
          description: ID of the asset in form of a string
          required: true
          schema:
            type: string
        - name: locale_code
          in: path
          description: Locale for which files should be processed
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the asset to process
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/bulk_actions/actions/{bulk_action_id}:
    get:
      operationId: getABulkAction
      summary: Get a bulk action
      description: Returns a bulk action by ID. Records are retained for 7 days.
      tags:
        - bulkActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space as a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment as a string, falls back to `master` if not specified.
          required: true
          schema:
            type: string
        - name: bulk_action_id
          in: path
          description: ID of the bulk action as a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_actions/publish:
    post:
      operationId: publishABulkAction
      summary: Publish a bulk action
      description: >-
        Publishes all content linked in the payload. Requires publish permissions on each item; limited by the number of
        active bulk actions.
      tags:
        - bulkActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space as a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment as a string, falls back to `master` if not specified.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_actions/unpublish:
    post:
      operationId: unpublishABulkAction
      summary: Unpublish a bulk action
      description: >-
        Unpublishes all content linked in the payload. Requires unpublish permissions on each item; limited by the
        number of active bulk actions.
      tags:
        - bulkActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space as a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment as a string, falls back to `master` if not specified.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_actions/validate:
    post:
      operationId: validateABulkAction
      summary: Validate a bulk action
      description: >-
        Validates entities before publishing. Requires publish permissions on each entity; limited by the number of
        active bulk actions.
      tags:
        - bulkActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space as a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment as a string, falls back to `master` if not specified.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/bulk_actions:
    post:
      operationId: createALocaleBasedBulkAction
      summary: Create a locale-based bulk action
      tags:
        - bulkActions
      parameters:
        - name: space_id
          in: path
          description: ID of the space as a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment as a string, falls back to `master` if not specified.
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions:
    get:
      operationId: getAllAppDefinitions
      summary: Get all app definitions
      tags:
        - appDefinitions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createANewAppDefinition
      summary: Create a new app definition
      tags:
        - appDefinitions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}:
    get:
      operationId: getAnAppDefinition
      summary: Get an app definition
      tags:
        - appDefinitions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnAppDefinition
      summary: Update an app definition
      tags:
        - appDefinitions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnAppDefinition
      summary: Delete an app definition
      tags:
        - appDefinitions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_uploads:
    post:
      operationId: createAnAppUpload
      summary: Create an app upload
      tags:
        - appUploads
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_uploads/{app_upload_id}:
    get:
      operationId: getAnAppUpload
      summary: Get an app upload
      tags:
        - appUploads
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_upload_id
          in: path
          description: app_upload_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/app_bundles:
    get:
      operationId: getAllAppBundles
      summary: Get all app bundles
      tags:
        - appBundles
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createANewAppBundle
      summary: Create a new app bundle
      tags:
        - appBundles
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/app_bundles/{app_bundle_id}:
    get:
      operationId: getAnAppBundle
      summary: Get an app bundle
      tags:
        - appBundles
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: app_bundle_id
          in: path
          description: app_bundle_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnAppBundle
      summary: Delete an app bundle
      tags:
        - appBundles
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: app_bundle_id
          in: path
          description: app_bundle_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/details:
    get:
      operationId: getAppDetails
      summary: Get app details
      tags:
        - appDetails
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrUpdateAppDetails
      summary: Create or update app details
      tags:
        - appDetails
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAppDetails
      summary: Delete app details
      tags:
        - appDetails
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/event_subscription:
    get:
      operationId: getAnAppEventSubscription
      summary: Get an app event subscription
      tags:
        - appEventSubscriptions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateOrSubscribeToEvents
      summary: Update or subscribe to events
      tags:
        - appEventSubscriptions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnAppEventSubscription
      summary: Delete an app event subscription
      tags:
        - appEventSubscriptions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/signing_secret:
    get:
      operationId: getTheCurrentAppSigningSecret
      summary: Get the current app signing secret
      tags:
        - appSigningSecret
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: createOrOverwriteTheAppSigningSecret
      summary: Create or overwrite the app signing secret
      tags:
        - appSigningSecret
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: removeTheCurrentAppSigningSecret
      summary: Remove the current app signing secret
      tags:
        - appSigningSecret
      parameters:
        - name: organization_id
          in: path
          description: ID of the organization
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_definition_id}/signed_requests:
    post:
      operationId: createASignedRequest
      summary: Create a signed request
      tags:
        - appSignedRequest
      parameters:
        - name: space_id
          in: path
          description: ID of the space
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: ID of the app definition
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/keys:
    get:
      operationId: getAllAppKeys
      summary: Get all app keys
      tags:
        - appKeys
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createANewAppKey
      summary: Create a new app key
      tags:
        - appKeys
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/keys/{key_kid}:
    get:
      operationId: getAnAppKey
      summary: Get an app key
      tags:
        - appKeys
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: key_kid
          in: path
          description: key_kid identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteAnAppKey
      summary: Delete an app key
      tags:
        - appKeys
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: key_kid
          in: path
          description: key_kid identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /organizations/{organization_id}/app_definitions/{app_definition_id}/access_grants:
    get:
      operationId: queryAccessGrantsOfAAppDefinition
      summary: Query Access Grants of a App Definition
      tags:
        - appAccessGrants
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createOneAccessGrant
      summary: Create One Access Grant
      tags:
        - appAccessGrants
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/access_grants/{access_grant_id}:
    delete:
      operationId: deleteOneAccessGrant
      summary: Delete One Access Grant
      tags:
        - appAccessGrants
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: access_grant_id
          in: path
          description: access_grant_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/app_installations:
    get:
      operationId: getAllAppInstallations
      summary: Get all app installations
      tags:
        - appInstallations
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /app_definitions/{app_definition_id}/app_installations:
    get:
      operationId: getAllInstallationsOfAnAppWithinAnOrganization
      summary: Get all installations of an app within an organization
      tags:
        - appInstallations
      parameters:
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: sys.organization.sys.id[in]
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_definition_id}:
    get:
      operationId: getAnAppInstallation
      summary: Get an app installation
      tags:
        - appInstallations
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: installOrUpdateAnApp
      summary: Install or update an app
      tags:
        - appInstallations
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: uninstallAnApp
      summary: Uninstall an app
      tags:
        - appInstallations
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_definition_id}/access_tokens:
    post:
      operationId: issueATokenForAnAppInstallationInASpaceEnvironment
      summary: Issue a token for an app installation in a space environment
      tags:
        - appAccessToken
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/actions:
    get:
      operationId: getAllActionsOfAnApp
      summary: Get all actions of an app
      tags:
        - appActions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAnAction
      summary: Create an action
      tags:
        - appActions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{external_environment_id}/actions:
    get:
      operationId: getAllActionsOfAnEnvironment
      summary: Get all actions of an environment
      tags:
        - appActions
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: external_environment_id
          in: path
          description: external_environment_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/actions/{app_action_id}:
    get:
      operationId: readAnAction
      summary: Read an action
      tags:
        - appActions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAnAction
      summary: Update an action
      tags:
        - appActions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAnAction
      summary: Delete an action
      tags:
        - appActions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/actions/{app_action_id}/calls:
    post:
      operationId: triggerAnAction
      summary: Trigger an action
      tags:
        - appActionCalls
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/actions/{app_action_id}/calls/{call_id}:
    get:
      operationId: getACall
      summary: Get a call
      tags:
        - appActionCalls
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: call_id
          in: path
          description: call_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/actions/{app_action_id}/calls/{call_id}/response:
    get:
      operationId: getRawResponse
      summary: Get raw response
      tags:
        - appActionCalls
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: app_action_id
          in: path
          description: app_action_id identifier
          required: true
          schema:
            type: string
        - name: call_id
          in: path
          description: call_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_actions_categories:
    get:
      operationId: getAppActionCategories
      summary: Get app action categories
      tags:
        - appActionCategories
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/functions/{function_id}:
    get:
      operationId: getAFunction
      summary: Get a function
      tags:
        - functions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: function_id
          in: path
          description: function_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/app_definitions/{app_definition_id}/functions:
    get:
      operationId: getAllFunctions
      summary: Get all functions
      tags:
        - functions
      parameters:
        - name: organization_id
          in: path
          description: organization_id identifier
          required: true
          schema:
            type: string
        - name: app_definition_id
          in: path
          description: app_definition_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/functions:
    get:
      operationId: getAllFunctionsForAnEnvironment
      summary: Get all functions for an environment
      tags:
        - functions
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/functions/{function_id}/logs/{log_id}:
    get:
      operationId: getAFunctionLog
      summary: Get a function log
      tags:
        - functionLogs
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: function_id
          in: path
          description: function_id identifier
          required: true
          schema:
            type: string
        - name: log_id
          in: path
          description: log_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: x-contentful-enable-alpha-feature
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /spaces/{space_id}/environments/{environment_id}/app_installations/{app_installation_id}/functions/{function_id}/logs:
    get:
      operationId: getAllFunctionLogs
      summary: Get all function logs
      tags:
        - functionLogs
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: app_installation_id
          in: path
          description: app_installation_id identifier
          required: true
          schema:
            type: string
        - name: function_id
          in: path
          description: function_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: x-contentful-enable-alpha-feature
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/organization_periodic_usages:
    get:
      operationId: getOrganizationUsage
      summary: Get organization usage
      description: >
        <Info>**Deprecated. Sunset: 2027-02-28.** Use [Get aggregated
        usage](/references/content-management-api/usage/get-usage-aggregated) instead. See the [Usage migration
        guide](/references/content-management-api/usage-migration-guide) for a full mapping of parameters and response
        shapes.</Info>


        Query organization usage by `metric` for a given date range. If `startAt` and `endAt` are not passed through the
        query a historical data for the last 45 days will be returned by default.
      tags:
        - usage
      parameters:
        - name: organization_id
          in: path
          description: Id of organization
          required: true
          schema:
            type: string
        - name: metric
          in: query
          description: Comma separated list of API types (cma,cda,cpa,gql)
          required: false
          schema:
            type: string
        - name: startAt
          in: query
          description: Date in `yyyy-mm-dd` format
          required: false
          schema:
            type: string
        - name: endAt
          in: query
          description: Date in `yyyy-mm-dd` format
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Order by `usage`. Default value is `"-usage"` and describes a descending usage order.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/space_periodic_usages:
    get:
      operationId: getSpaceUsage
      summary: Get space usage
      description: >
        <Info>**Deprecated. Sunset: 2027-02-28.** Use [Get aggregated
        usage](/references/content-management-api/usage/get-usage-aggregated) with
        `filter[sys.dimensions.space.sys.id]={spaceId}` instead. See the [Usage migration
        guide](/references/content-management-api/usage-migration-guide) for a full mapping of parameters and response
        shapes.</Info>


        Query organization usage by space and `metric` for a given date range.
      tags:
        - usage
      parameters:
        - name: organization_id
          in: path
          description: Id of organization
          required: true
          schema:
            type: string
        - name: metric
          in: query
          description: Comma separated list of API types (cma,cda,cpa,gql)
          required: false
          schema:
            type: string
        - name: startAt
          in: query
          description: Date in `yyyy-mm-dd` format
          required: false
          schema:
            type: string
        - name: endAt
          in: query
          description: Date in `yyyy-mm-dd` format
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: Order by `usage`. Default value is `"-usage"` and describes a descending usage order.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/usages/{metric_key}:
    get:
      operationId: getUsageAggregated
      summary: Get aggregated usage
      description: >
        Returns aggregated usage for a single metric over a configurable date range and granularity. This is the
        recommended endpoint for consuming Usage API data — it replaces the legacy `organization_periodic_usages` and
        `space_periodic_usages` endpoints (see the [Usage migration
        guide](/references/content-management-api/usage-migration-guide)).


        One request returns one metric. To fetch multiple metrics, issue one call per `metric_key`.


        ### Available metrics


        Pass one of the following as `metric_key`:


        | `metric_key`             | What it counts                                           |

        |--------------------------|----------------------------------------------------------|

        | `api_call_cma`           | Content Management API requests                          |

        | `api_call_cda`           | Content Delivery API requests                            |

        | `api_call_cpa`           | Content Preview API requests                             |

        | `api_call_graphql`       | GraphQL API requests                                     |

        | `api_call_total`         | Total API requests across CMA, CDA, CPA, and GraphQL     |

        | `functions_invocations`  | Contentful Functions invocations                         |

        | `asset_bandwidth`        | Asset bandwidth served                                   |

        | `ai_action_invocation`   | AI Action invocations                                    |

        | `ai_action_word_count`   | Words processed by AI Actions                            |

        | `ai_consumption_unit`    | AI consumption units                                     |


        ### Supported dimensions per metric


        Each metric supports a fixed set of dimensions that you can use in `group`, `filter`, and `order`. Dimension
        keys use the fully qualified form `sys.dimensions.<name>.sys.<suffix>` everywhere — including `order`, where you
        prefix `-` for descending (e.g. `order=-sys.dimensions.space.sys.id`). The synthetic column `total_usage` is a
        bare token (`order=total_usage`, `order=-total_usage`) and is only valid in `order`.


        | `metric_key`             | Allowed
        dimensions                                                                                                                             
        |

        |--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------|

        | `api_call_cma`           |
        `sys.dimensions.space.sys.id`                                                                                                                  
        |

        | `api_call_cda`           |
        `sys.dimensions.space.sys.id`                                                                                                                  
        |

        | `api_call_cpa`           |
        `sys.dimensions.space.sys.id`                                                                                                                  
        |

        | `api_call_graphql`       |
        `sys.dimensions.space.sys.id`                                                                                                                  
        |

        | `api_call_total`         |
        `sys.dimensions.space.sys.id`                                                                                                                  
        |

        | `functions_invocations`  | `sys.dimensions.space.sys.id`, `sys.dimensions.app.sys.id`,
        `sys.dimensions.function.sys.id`                                                    |

        | `asset_bandwidth`        | `sys.dimensions.space.sys.id`,
        `sys.dimensions.asset.sys.id`                                                                                   
        |

        | `ai_action_invocation`   | `sys.dimensions.space.sys.id`, `sys.dimensions.ai_action.sys.id`,
        `sys.dimensions.model.sys.provider`, `sys.dimensions.model.sys.id`            |

        | `ai_action_word_count`   | `sys.dimensions.space.sys.id`, `sys.dimensions.ai_action.sys.id`,
        `sys.dimensions.model.sys.provider`, `sys.dimensions.model.sys.id`            |

        | `ai_consumption_unit`    | `sys.dimensions.space.sys.id`, `sys.dimensions.ai_action.sys.id`,
        `sys.dimensions.model.sys.provider`, `sys.dimensions.model.sys.id`            |


        Multi-value filters take the `[in]` suffix (up to 10 ids), e.g.
        `filter[sys.dimensions.space.sys.id][in]=id1,id2`.


        ### Space coverage


        `api_call_total` covers every space in your organization, including spaces that made no API calls in the
        requested period — those report `0`. Sorting descending by total (`order=-total_usage`) lists them last, and
        `total` in the response is the number of spaces in your organization.


        The per-API metrics (`api_call_cma`, `api_call_cda`, `api_call_cpa`, and `api_call_graphql`) only cover spaces
        that recorded usage for that specific API.


        ### Date range


        `date[gte]` and `date[lte]` are required and accept `yyyy-mm-dd` or full ISO-8601 date-time. **The API only
        serves data from the last 12 months** — `date[gte]` cannot be more than 12 months before the current day,
        irrespective of the requested `granularity`.


        The `granularity` parameter controls bucket size: `P1D` (daily; max 31-day query window) or `P1M` (monthly; max
        12 calendar months including the current month). Default is `P1D`.


        Available to Organization Admins and Organization Owners.
      tags:
        - usage
      parameters:
        - name: organization_id
          in: path
          description: Id of organization
          required: true
          schema:
            type: string
        - name: metric_key
          in: path
          description: The metric to query. One metric per request.
          required: true
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdUsagesMetricKeyGetParametersMetricKey'
        - name: date[gte]
          in: query
          description: >-
            Start of the query window (inclusive). Accepts `yyyy-mm-dd` or full ISO-8601. Cannot be more than 12 months
            before the current day — the API only serves data from the last 12 months.
          required: true
          schema:
            type: string
            format: date
        - name: date[lte]
          in: query
          description: >-
            End of the query window (inclusive). Accepts `yyyy-mm-dd` or full ISO-8601. Maximum window is 31 days for
            `granularity=P1D` and 12 months (including the current month) for `granularity=P1M`.
          required: true
          schema:
            type: string
            format: date
        - name: granularity
          in: query
          description: >-
            Bucket size in ISO-8601 duration format. `P1D` returns one point per day (max 31-day window). `P1M` returns
            one point per month (max 12 months). Defaults to `P1D`.
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdUsagesMetricKeyGetParametersGranularity'
        - name: group
          in: query
          description: >-
            Comma-separated list of dimension keys to group results by, for example `sys.dimensions.space.sys.id`. When
            omitted, results are returned aggregated across all dimensions.
          required: false
          schema:
            type: string
        - name: filter[sys.dimensions.space.sys.id]
          in: query
          description: >-
            Restrict results to a single space. Use `filter[sys.dimensions.space.sys.id][in]=<id1>,<id2>` (up to 10 ids)
            to restrict to a set of spaces. Other dimension filters follow the same pattern
            (`filter[sys.dimensions.<dimension>.sys.id]`).
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/usages-detailed/asset_bandwidth:
    get:
      operationId: getUsageAssetBandwidthDetailed
      summary: Get detailed asset bandwidth usage
      description: >
        Returns the top 30 assets by bandwidth used for an organization over a given date range, ranked descending and
        grouped by asset and space. This is a fixed-shape leaderboard, not a general-purpose query endpoint — unlike
        [Get aggregated usage](/references/content-management-api/usage/get-usage-aggregated), it does not support
        `group`, `filter`, or `order` parameters, and covers a single metric (`asset_bandwidth`) only.


        `granularity` is locked to `P1D` (daily) — there is no monthly option.


        `date[gte]` and `date[lte]` are both required. The query window must not exceed 31 days and cannot extend into
        the future. Data is available from January 2026 onward, with a maximum lookback of 12 months.


        For organization-wide or space-scoped totals across other metrics, or for a longer date range, use [Get
        aggregated usage](/references/content-management-api/usage/get-usage-aggregated) instead.


        Available to Organization Admins and Organization Owners.
      tags:
        - usage
      parameters:
        - name: organization_id
          in: path
          description: Id of organization
          required: true
          schema:
            type: string
        - name: date[gte]
          in: query
          description: >-
            Start of the query window (inclusive). Accepts `yyyy-mm-dd` or full ISO-8601. Window must not exceed 31 days
            and cannot extend into the future. Cannot be more than 12 months before the current day.
          required: true
          schema:
            type: string
            format: date
        - name: date[lte]
          in: query
          description: >-
            End of the query window (inclusive). Accepts `yyyy-mm-dd` or full ISO-8601. Window must not exceed 31 days
            and cannot extend into the future.
          required: true
          schema:
            type: string
            format: date
        - name: granularity
          in: query
          description: Bucket size in ISO-8601 duration format. Only `P1D` (daily) is supported today. Defaults to `P1D`.
          required: false
          schema:
            $ref: '#/components/schemas/OrganizationsOrganizationIdUsagesDetailedAssetBandwidthGetParametersGranularity'
            default: P1D
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/logging_configurations:
    get:
      operationId: getAllLoggingConfigurations
      summary: Get all logging configurations
      description: Returns a paginated collection of logging configurations for the organization.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: source
          in: query
          description: 'Filter configurations by source type. Possible value: `cda`'
          required: false
          schema:
            type: string
        - name: destination
          in: query
          description: 'Filter configurations by destination type. Possible value: `aws_s3`'
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createLoggingConfiguration
      summary: Create a logging configuration
      description: >-
        Creates a logging configuration for the organization. AWS S3 destinations require `bucketName`, `iamArn`, and
        `region` credentials.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '422':
          description: Unprocessable Entity - Organization has reached its logging configuration limit
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /organizations/{organization_id}/logging_configurations/{configuration_id}:
    get:
      operationId: getLoggingConfiguration
      summary: Get a logging configuration
      description: Returns a single logging configuration by ID.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: configuration_id
          in: path
          description: Id of the logging configuration
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    delete:
      operationId: deleteLoggingConfiguration
      summary: Delete a logging configuration
      description: Deletes a logging configuration. This stops future log deliveries for the configuration.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: configuration_id
          in: path
          description: Id of the logging configuration
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/logging_configurations/{configuration_id}/status:
    get:
      operationId: getLoggingConfigurationDeliveryStatus
      summary: Get configuration delivery status
      description: Returns cursor-paginated delivery attempt history for a configuration. Records are retained for 180 days.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: configuration_id
          in: path
          description: Id of the logging configuration
          required: true
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of records to return (1-100)
          required: false
          schema:
            type: number
            format: double
        - name: pageNext
          in: query
          description: Cursor token returned via pages.next
          required: false
          schema:
            type: string
        - name: pagePrev
          in: query
          description: Cursor token returned via pages.prev
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
  /organizations/{organization_id}/logging_configurations/{configuration_id}/credentials:
    put:
      operationId: updateLoggingConfigurationCredentials
      summary: Update logging configuration credentials
      description: >-
        Replaces credentials for an existing logging configuration. The destination type cannot be changed via this
        endpoint.
      tags:
        - enterpriseObservability
      parameters:
        - name: organization_id
          in: path
          description: Id of the organization
          required: true
          schema:
            type: string
        - name: configuration_id
          in: path
          description: Id of the logging configuration
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '400':
          description: Bad Request - Credentials do not match the destination type of the existing configuration
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/workflow_definitions:
    get:
      operationId: getAllWorkflowDefinitions
      summary: Get all workflow definitions
      description: Returns a paginated list of workflow definitions for the environment. Accessible to all users.
      tags:
        - workflowDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAWorkflowDefinition
      summary: Create a workflow definition
      description: Creates a new workflow definition. Only org or space admins can create workflow definitions.
      tags:
        - workflowDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/workflow_definitions/{workflow_definition_id}:
    get:
      operationId: getAWorkflowDefinition
      summary: Get a workflow definition
      description: Returns a single workflow definition by ID. Accessible to all users.
      tags:
        - workflowDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_definition_id
          in: path
          description: ID of the workflow definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAWorkflowDefinition
      summary: Update a workflow definition
      description: Updates a workflow definition by ID. Only org or space admins can update workflow definitions.
      tags:
        - workflowDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_definition_id
          in: path
          description: ID of the workflow definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the workflow definition to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: deleteAWorkflowDefinition
      summary: Delete a workflow definition
      description: Deletes a workflow definition by ID. Only org or space admins can delete workflow definitions.
      tags:
        - workflowDefinitions
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_definition_id
          in: path
          description: ID of the workflow definition in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/workflows:
    get:
      operationId: getAllWorkflows
      summary: Get all workflows
      description: Returns workflows matching the specified query filters. Accessible to all users.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: stepId[in]
          in: query
          description: Comma-separated list with step IDs. A workflow must be linked to one of those steps.
          required: false
          schema:
            type: string
        - name: sys.entity.sys.linkType
          in: query
          description: This must equal `entry` if defined. This must be defined together with the next parameter.
          required: false
          schema:
            type: string
        - name: sys.entity.sys.id[in]
          in: query
          description: Comma-separated list with entry IDs. A workflow must be linked to one of those entries.
          required: false
          schema:
            type: string
        - name: sys.workflowDefinition.sys.id
          in: query
          description: Filter workflows by the ID of the linked workflow definition.
          required: false
          schema:
            type: string
        - name: order
          in: query
          description: |
            Orders the query results by a specified attribute. The prefix `-` inverts the order (descending).
            Supported values: `sys.updatedAt`, `-sys.updatedAt`, `sys.createdAt`, `-sys.createdAt`
          required: false
          schema:
            type: string
        - name: skip
          in: query
          description: The number of elements to skip before returning matching workflows.
          required: false
          schema:
            type: number
            format: double
        - name: limit
          in: query
          description: Limit the number of workflows being returned in the response.
          required: false
          schema:
            type: number
            format: double
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    post:
      operationId: createAWorkflow
      summary: Create a workflow
      description: Creates a workflow for an entry. Any user with read access to the entry can create a workflow.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: space_id identifier
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: environment_id identifier
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '201':
          description: Created - Resource created successfully
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
  /spaces/{space_id}/environments/{environment_id}/workflows/{workflow_id}:
    get:
      operationId: getAWorkflow
      summary: Get a workflow
      description: Returns a workflow by ID. Accessible to all users.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
    put:
      operationId: updateAWorkflow
      summary: Update a workflow
      description: >-
        Advances or updates a workflow step. Only org or space admins can update by default; step-level permissions can
        grant access to other users.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the workflow to update
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties:
                description: Any type
    delete:
      operationId: cancelAWorkflow
      summary: Cancel a workflow
      description: >-
        Cancels a workflow. Only org or space admins can cancel by default; step-level permissions can grant access to
        other users.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the workflow to cancel
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/workflows/{workflow_id}/completed:
    put:
      operationId: completeAWorkflow
      summary: Complete a workflow
      description: >-
        Completes a workflow. Only org or space admins can complete by default; step-level permissions can grant access
        to other users.
      tags:
        - workflows
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: workflow_id
          in: path
          description: ID of the workflow in form of a string
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
        - name: X-Contentful-Version
          in: header
          description: Version of the workflow to complete
          required: true
          schema:
            type: string
      responses:
        '204':
          description: No Content - Request successful, no content returned
          content:
            application/json:
              schema:
                type: object
                properties: {}
  /spaces/{space_id}/environments/{environment_id}/workflows_changelog:
    get:
      operationId: getAllWorkflowChangelogRecords
      summary: Get all workflow changelog records
      description: >-
        Returns workflow changelog records matching the specified filters, sorted by event date descending. Accessible
        to any user with read access to the specified entry.
      tags:
        - workflowsChangelog
      parameters:
        - name: space_id
          in: path
          description: ID of the space in form of a string
          required: true
          schema:
            type: string
        - name: environment_id
          in: path
          description: ID of the environment in form of a string
          required: true
          schema:
            type: string
        - name: entity.sys.linkType
          in: query
          description: This must equal "entry"
          required: true
          schema:
            type: string
        - name: entity.sys.id
          in: query
          description: ID of the entry for which the workflow was executed
          required: true
          schema:
            type: string
        - name: workflow.sys.id
          in: query
          description: ID of the associated workflow
          required: false
          schema:
            type: string
        - name: eventAt[lte]
          in: query
          description: Filter records based on their occurrence before or on the specified ISO 8601 date
          required: false
          schema:
            type: string
        - name: eventAt[gte]
          in: query
          description: Filter records based on their occurrence after or on the specified ISO 8601 date
          required: false
          schema:
            type: string
        - name: workflowDefinition.sys.id[in]
          in: query
          description: Comma-separated list of workflow definition IDs used to filter records
          required: false
          schema:
            type: string
        - name: skip
          in: query
          description: The number of elements to skip before returning matching changelog records
          required: false
          schema:
            type: number
            format: double
        - name: limit
          in: query
          description: Limit the number of changelog records being returned in the response
          required: false
          schema:
            type: number
            format: double
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK - Request successful
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  description: Any type
servers:
  - url: https://api.contentful.com
    description: Content Management API server
components:
  schemas:
    SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItemsAddOn:
      type: string
      enum:
        - contentTypes
        - records
        - environments
      description: Add-on type
      title: SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItemsAddOn
    SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItems:
      type: object
      properties:
        add_on:
          $ref: >-
            #/components/schemas/SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItemsAddOn
          description: Add-on type
        allocation:
          type: number
          format: double
          description: Total of allocation
      title: SpacesSpaceIdSpaceAddOnsPutRequestBodyContentApplicationVndContentfulManagementV1JsonSchemaItems
    OrganizationsOrganizationIdTaxonomyConceptsGetParametersOrder:
      type: string
      enum:
        - sys.createdAt
        - sys.updatedAt
        - prefLabel
        - '-sys.createdAt'
        - '-sys.updatedAt'
        - '-prefLabel'
      title: OrganizationsOrganizationIdTaxonomyConceptsGetParametersOrder
    OrganizationsOrganizationIdTaxonomyConceptsConceptIdDescendantsGetParametersOrder:
      type: string
      enum:
        - sys.createdAt
        - sys.updatedAt
        - prefLabel
        - '-sys.createdAt'
        - '-sys.updatedAt'
        - '-prefLabel'
      title: OrganizationsOrganizationIdTaxonomyConceptsConceptIdDescendantsGetParametersOrder
    OrganizationsOrganizationIdTaxonomyConceptsConceptIdAncestorsGetParametersOrder:
      type: string
      enum:
        - sys.createdAt
        - sys.updatedAt
        - prefLabel
        - '-sys.createdAt'
        - '-sys.updatedAt'
        - '-prefLabel'
      title: OrganizationsOrganizationIdTaxonomyConceptsConceptIdAncestorsGetParametersOrder
    OrganizationsOrganizationIdTaxonomyConceptSchemesGetParametersOrder:
      type: string
      enum:
        - sys.createdAt
        - sys.updatedAt
        - prefLabel
        - totalConcepts
        - '-sys.createdAt'
        - '-sys.updatedAt'
        - '-prefLabel'
        - '-totalConcepts'
      title: OrganizationsOrganizationIdTaxonomyConceptSchemesGetParametersOrder
    SpacesSpaceIdAiActionsGetParametersStatus:
      type: string
      enum:
        - published
        - all
      title: SpacesSpaceIdAiActionsGetParametersStatus
    SpacesSpaceIdEnvironmentsEnvironmentIdTasksGetParametersFilter:
      type: string
      enum:
        - myPendingTasks
      title: SpacesSpaceIdEnvironmentsEnvironmentIdTasksGetParametersFilter
    SpacesSpaceIdEnvironmentsEnvironmentIdReleasesGetParametersSysSchemaVersion:
      type: string
      enum:
        - Release.v2
      title: SpacesSpaceIdEnvironmentsEnvironmentIdReleasesGetParametersSysSchemaVersion
    OrganizationsOrganizationIdUsagesMetricKeyGetParametersMetricKey:
      type: string
      enum:
        - api_call_cma
        - api_call_cda
        - api_call_cpa
        - api_call_graphql
        - api_call_total
        - functions_invocations
        - asset_bandwidth
        - ai_action_invocation
        - ai_action_word_count
        - ai_consumption_unit
      title: OrganizationsOrganizationIdUsagesMetricKeyGetParametersMetricKey
    OrganizationsOrganizationIdUsagesMetricKeyGetParametersGranularity:
      type: string
      enum:
        - P1D
        - P1M
      title: OrganizationsOrganizationIdUsagesMetricKeyGetParametersGranularity
    OrganizationsOrganizationIdUsagesDetailedAssetBandwidthGetParametersGranularity:
      type: string
      enum:
        - P1D
      default: P1D
      title: OrganizationsOrganizationIdUsagesDetailedAssetBandwidthGetParametersGranularity
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
