openapi: 3.0.3
info:
  title: AEM Content Fragment Delivery with OpenAPI
  version: '2026.10'
  description: |
    The AEM Content Fragments Delivery API provides callers with efficient endpoints to
    retrieve Content Fragments and their associated Models for building rich applications.

    <h2>Enabling the Content Fragments Delivery API</h2>

    To enable Content Fragment Delivery with OpenAPI on AEM as a Cloud Service please follow the steps
    described in the official <a href="https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/headless/aem-content-fragment-delivery-with-openapi" target="_blank">documentation</a>.

    Notes on authentication:
    - The publish bucket of the API doesn't require authentication.
    - The preview bucket requires Bearer token authentication with <a href="https://experienceleague.adobe.com/en/docs/experience-manager-cloud-service/content/implementing/developing/generating-access-tokens-for-server-side-apis" target="_blank">Access Token</a> when the environment is opted-in for this feature.
servers:
  - url: https://{bucket}.adobeaemcloud.com/adobe/contentFragments
    variables:
      bucket:
        default: ''
        description: The bucket to use for this request, e.g. author-p12345-e123456
security:
  - {}
  - bearerAuth: []
tags:
  - name: Fragment Delivery
  - name: Model Delivery
  - name: Fragment Variations
  - name: References
  - name: HTML Fragment Delivery
    description: Operations for retrieving published HTML fragments
paths:
  /:
    get:
      operationId: fragments/getFragments
      tags:
        - Fragment Delivery
      summary: List all Content Fragments
      description: |
        This operation provides support for retrieving all the Content Fragments.

        By default this call will return a maximum of 50 items.

        The caller can define other limits suited to their application (see the `limit` query
        parameter), but the limit cannot be higher than 50. To ask for the next set of items
        pass the value of the `cursor` provided in the response to the `cursor` query parameter.
      parameters:
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit'
        - in: query
          name: path
          description: Optional UTF-8 encoded parameter to specify a path where to start looking for content fragments.
          required: false
          schema:
            type: string
          examples:
            one-fragment:
              value: /content/dam/wknd-shared/en/contributors/ian-provo
              description: Get exactly one '/ian-provo' content fragment.
            multiple-fragments:
              value: /content/dam/wknd-shared/en/contributors
              description: Get all child content fragments under '/contributors' folder.
      responses:
        '200':
          description: A response containing a potentially paginated list of content fragments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentListResult'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}:
    get:
      operationId: fragments/getFragment
      tags:
        - Fragment Delivery
      summary: Get a Content Fragment
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentId'
        - $ref: '#/components/parameters/ReferencesOptional'
        - $ref: '#/components/parameters/Depth'
        - $ref: '#/components/parameters/Hydrated'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentResponse'
              examples:
                content-fragment-without-references:
                  $ref: '#/components/examples/ContentFragmentWithoutReferences'
                content-fragment-with-references-not-hydrated:
                  $ref: '#/components/examples/ContentFragmentWithReferencesNotHydrated'
                content-fragment-with-references-hydrated:
                  $ref: '#/components/examples/ContentFragmentWithReferencesHydrated'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /byPath:
    get:
      operationId: fragments/getFragmentByPath
      tags:
        - Fragment Delivery
      summary: Get a Content Fragment by path
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentPath'
        - $ref: '#/components/parameters/ReferencesOptional'
        - $ref: '#/components/parameters/Depth'
        - $ref: '#/components/parameters/Hydrated'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentResponse'
              examples:
                content-fragment-without-references:
                  $ref: '#/components/examples/ContentFragmentWithoutReferences'
                content-fragment-with-references-not-hydrated:
                  $ref: '#/components/examples/ContentFragmentWithReferencesNotHydrated'
                content-fragment-with-references-hydrated:
                  $ref: '#/components/examples/ContentFragmentWithReferencesHydrated'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/references:
    get:
      operationId: fragments/getFragmentReferences
      tags:
        - References
      summary: Get the references of a Content Fragment
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentId'
        - $ref: '#/components/parameters/References'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentReferences'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/model:
    get:
      operationId: fragments/getModel
      tags:
        - Fragment Delivery
      summary: Get the model details of a Content Fragment
      description: |
        This operation allows retrieving the model details of a Content Fragment.

        This operation is an alias for `/fragmentModels/{modelId}`.
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentId'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentModel'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/variations:
    get:
      operationId: fragments/getVariationsNamesForFragment
      tags:
        - Fragment Variations
      summary: List all Variations of a Content Fragment
      description: |
        This operation provides support for retrieving all the Variations of a Content Fragment.
        By default this call will return a maximum of 50 items.

        The caller can define other limits suited to their application (see the `limit` query parameter),
        but the limit cannot be higher than 50. To ask for the next set of items pass the value of the `cursor`
        provided in the response to the `cursor` query parameter.
      parameters:
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/FragmentId'
      responses:
        '200':
          description: A response containing a potentially paginated list of content fragments variations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentVariationListResult'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/variations/{variationName}:
    get:
      operationId: fragments/getFragmentVariations
      tags:
        - Fragment Variations
      summary: Get a Content Fragment Variation
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentId'
        - $ref: '#/components/parameters/VariationName'
        - $ref: '#/components/parameters/ReferencesOptional'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentVariationResponse'
              examples:
                content-fragment-variation-without-references:
                  $ref: '#/components/examples/ContentFragmentVariationWithoutReferences'
                content-fragment-variation-with-references-not-hydrated:
                  $ref: '#/components/examples/ContentFragmentVariationWithReferencesNotHydrated'
                content-fragment-variation-with-references-hydrated:
                  $ref: '#/components/examples/ContentFragmentVariationWithReferencesHydrated'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/variations/{variationName}/references:
    get:
      operationId: fragments/getFragmentVariationReferences
      tags:
        - References
      summary: Get the references for a Variation of a Content Fragment
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentId'
        - $ref: '#/components/parameters/References'
        - $ref: '#/components/parameters/VariationName'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentReferences'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{fragmentId}/referencedBy:
    get:
      operationId: fragments/getFragmentReferencedBy
      summary: Get the parent references of a Content Fragment
      description: |
        This operation returns the parent references of type Page, Experience Fragment and Content Fragments which are 
        referencing the given Content Fragment.
        By default this call will return a maximum of 50 items.

        The caller can define other limits suited to their application (see the `limit` query
        parameter), but the limit cannot be higher than 50. To ask for the next set of items
        pass the value of the `cursor` provided in the response to the `cursor` query parameter.
      tags:
        - References
      parameters:
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/FragmentId'
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ParentReferencesList'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /models:
    get:
      operationId: models/getModels
      tags:
        - Model Delivery
      summary: |
        List all Content Fragment Models
      description: |
        This operation provides support for retrieving all the Content Fragment Models.

        When the request is authenticated, it will return the Content Fragment Models accessible to the current user,
        determined via the applied request authorization. This second set might be a superset of the one retrieved via an
        unauthenticated request.

        By default this call will return a maximum of 50 items.

        The caller can define other limits suited to their application (see the `limit` query
        parameter), but the limit cannot be higher than 50. To ask for the next set of items
        pass the value of the `cursor` provided in the response to the `cursor` query parameter.
      parameters:
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: A list of Content Fragment Models was successfully returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentModelListResult'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /models/{modelId}:
    get:
      operationId: models/getModel
      tags:
        - Model Delivery
      summary: Get a Content Fragment Model
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentModelId'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentModel'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /models/{modelId}/jsonSchema:
    get:
      operationId: models/getModelSchema
      tags:
        - Model Delivery
      summary: Get the JSON Schema for Content Fragment Fields
      description: |
        The JSON schema can be used to describe and validate the fields of a Content Fragment based on a specific
        Content Fragment Model.
      parameters:
        - $ref: '#/components/parameters/If-None-Match'
        - $ref: '#/components/parameters/FragmentModelId'
      responses:
        '200':
          description: OK
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonSchema'
        '304':
          $ref: '#/components/responses/304_NotModified_ETag'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /models/{modelId}/fragments:
    get:
      operationId: models/getFragments
      tags:
        - Model Delivery
      summary: List all Content Fragments created based on the model
      description: |
        This operation provides support for retrieving all the Content Fragments
        accessible to the current user, determined via the applied request authorization.
        By default this call will return a maximum of 50 items.

        The caller can define other limits suited to their application (see the `limit` query
        parameter), but the limit cannot be higher than 50. To ask for the next set of items
        pass the value of the `cursor` provided in the response to the `cursor` query parameter.
      parameters:
        - $ref: '#/components/parameters/cursor'
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/FragmentModelId'
      responses:
        '200':
          description: A response containing a potentially paginated list of content fragments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentFragmentListResult'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
  /{templateId}/{fragmentId}/{variation}.html:
    get:
      summary: Get published HTML fragment
      security: []
      description: |
        Retrieves a published HTML fragment that was previously rendered and stored to the delivery tier.

        **URL Pattern:**
        ```
        https://{bucket}.adobeaemcloud.net/adobe/contentFragments/{templateId}/{fragmentId}/{variation}.html
        ```

        **Path Components:**
        - `{bucket}` - Publish bucket identifier (format: `publish-p{programId}-e{environmentId}`)
        - `{templateId}` - Template UUID or `generic_template` for default rendering
        - `{fragmentId}` - Content Fragment UUID
        - `{variation}` - Variation name (typically `main`)

        **Content Delivery:**
        - Content-Type: text/html
        - Caching: Appropriate cache-control headers are set for CDN delivery
        - The HTML is fully rendered and does not contain unresolved Handlebars placeholders
      operationId: getHtmlFragment
      tags:
        - HTML Fragment Delivery
      parameters:
        - $ref: '#/components/parameters/templateId'
        - $ref: '#/components/parameters/fragmentId'
        - $ref: '#/components/parameters/variation'
        - $ref: '#/components/parameters/If-None-Match'
      responses:
        '200':
          description: Successfully retrieved HTML fragment
          headers:
            ETag:
              $ref: '#/components/headers/ETag'
          content:
            text/html:
              schema:
                $ref: '#/components/schemas/HtmlContent'
              examples:
                default:
                  $ref: '#/components/examples/html-fragment-response'
        '304':
          $ref: '#/components/responses/304_NotModified'
        '400':
          $ref: '#/components/responses/400_BadRequest'
        '404':
          $ref: '#/components/responses/404_NotFound'
        '406':
          $ref: '#/components/responses/406_Unacceptable'
        '500':
          $ref: '#/components/responses/500_InternalServerError'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
  schemas:
    Cursor:
      description: |
        A cursor is an opaque string that can be used in API calls which support paginating the response. A non-existent cursor
        signifies that the returned list does not have more elements.
      type: string
      minLength: 1
    Limit:
      description: |
        For a paginated request, this parameter defines the maximum number of items to retrieve.
      type: integer
      format: int32
      minimum: 1
      maximum: 50
    UUID:
      description: Resource unique identifier
      type: string
      minLength: 36
      format: uuid
      example: 49af775d-0e7a-46c3-913d-00f762528373
    ContentFragmentPath:
      type: string
      minLength: 1
      pattern: ^\/content\/dam(\/.*)?$
      description: A valid path to a Content Fragment resource.
    Base64URLId:
      type: string
      minLength: 1
      description: |
        The `base64url` encoded representation of the resource path.

        This should be encoded using base64url (URL-safe base64), without padding (no `=` at the end), and using `-`
        and `_` instead of `+` and `/`.
      pattern: ^[A-Za-z0-9_-]+$
      example: L2NvbnRlbnQvZGFtL3drbmQtc2hhcmVkL2VuL2NvbnRyaWJ1dG9ycy9pYW4tcHJvdm8
    ContentFragmentModelIdentifier:
      type: object
      description: Minimal information about a Content Fragment Model.
      properties:
        id:
          $ref: '#/components/schemas/Base64URLId'
      required:
        - id
      example:
        id: L2NvbmYvZ2xvYmFsL3NldHRpbmdzL2RhbS9jZm0vbW9kZWxzL2Etc2ltcGxlLWNmbQ
    TextField:
      oneOf:
        - type: string
          title: Single value
          description: A string value
        - type: array
          title: Multi value
          items:
            type: string
            description: A string value
    LongNumberField:
      oneOf:
        - type: integer
          format: int64
          title: Single value
          description: A long number
        - type: array
          title: Multi value
          items:
            description: A long number
            type: integer
            format: int64
    DoubleNumberField:
      oneOf:
        - type: integer
          format: double
          title: Single value
          description: A fractional (double-precision) number
        - type: array
          title: Multi value
          items:
            type: integer
            format: double
            description: A fractional (double-precision) number
    BooleanField:
      description: A Boolean value
      type: boolean
    DateField:
      description: A date with the format yyyy-MM-dd
      type: string
      format: date
    DateTimeField:
      description: An offset date-time with the format yyyy-MM-dd'T'HH:mm:ss±hh:mm
      type: string
      format: date-time
    TimeField:
      oneOf:
        - type: string
          format: time
          title: Single value
          description: The time information in the HH:mm:ss format
        - type: array
          title: Multi value
          items:
            type: string
            format: time
            description: The time information in the HH:mm:ss format
    MimeType:
      type: string
      description: The mime type of a multiline text field
      enum:
        - text/html
        - text/plain
        - text/x-markdown
        - text/markdown
    LongTextField:
      oneOf:
        - type: object
          title: Single value
          properties:
            value:
              type: string
              description: A longer text, like a paragraph
            mimeType:
              $ref: '#/components/schemas/MimeType'
        - type: array
          title: Multi value
          items:
            type: object
            properties:
              value:
                type: string
                description: A longer text, like a paragraph
              mimeType:
                $ref: '#/components/schemas/MimeType'
    EnumerationField:
      oneOf:
        - type: string
          description: The enumeration key defined in the model
          title: Single value
        - type: array
          title: Multi value
          items:
            type: string
            description: The enumeration key defined in the model
    JsonField:
      description: The JSON data
      type: object
    TagId:
      description: Tag identifier
      type: string
    TagField:
      description: A field containing references to cq:Tags
      type: array
      items:
        $ref: '#/components/schemas/TagId'
      uniqueItems: true
    URN:
      description: A URN schema object
      type: string
      minLength: 1
      pattern: ^urn:[a-z0-9][a-z0-9-]{0,31}:[a-z0-9()+,-.:=@;$_!*'%/?#]+$
      example: urn:aaid:aem:49af775d-0e7a-46c3-913d-00f762528373
    ContentReferenceField:
      description: 'References to various content types like: plain text, rich text, content fragments,  images, audio clips or video clips'
      oneOf:
        - $ref: '#/components/schemas/URN'
          title: Single value
        - type: array
          title: Multi value
          items:
            $ref: '#/components/schemas/URN'
    FragmentReferenceField:
      description: The references to Content Fragments
      oneOf:
        - $ref: '#/components/schemas/UUID'
          title: Single value
        - type: array
          title: Multi value
          items:
            $ref: '#/components/schemas/UUID'
    ContentFragmentFields:
      type: object
      description: A field value of one of the supported types.
      additionalProperties:
        oneOf:
          - $ref: '#/components/schemas/TextField'
          - $ref: '#/components/schemas/LongNumberField'
          - $ref: '#/components/schemas/DoubleNumberField'
          - $ref: '#/components/schemas/BooleanField'
          - $ref: '#/components/schemas/DateField'
          - $ref: '#/components/schemas/DateTimeField'
          - $ref: '#/components/schemas/TimeField'
          - $ref: '#/components/schemas/LongTextField'
          - $ref: '#/components/schemas/EnumerationField'
          - $ref: '#/components/schemas/JsonField'
          - $ref: '#/components/schemas/TagField'
          - $ref: '#/components/schemas/ContentReferenceField'
          - $ref: '#/components/schemas/FragmentReferenceField'
    ContentFragment:
      description: A representation of a Content Fragment.
      type: object
      properties:
        id:
          $ref: '#/components/schemas/UUID'
        path:
          $ref: '#/components/schemas/ContentFragmentPath'
        name:
          type: string
          minLength: 1
          description: The name of the Content Fragment Resource.
        title:
          type: string
          minLength: 1
          description: The title of the Content Fragment.
        description:
          type: string
          description: Content Fragment description.
        model:
          $ref: '#/components/schemas/ContentFragmentModelIdentifier'
        fields:
          $ref: '#/components/schemas/ContentFragmentFields'
      required:
        - id
        - path
        - name
        - title
        - model
        - fields
    ContentFragmentListResult:
      description: |
        Paginated collection of content fragments.
      type: object
      properties:
        items:
          description: List of Content Fragments
          type: array
          items:
            $ref: '#/components/schemas/ContentFragment'
        cursor:
          $ref: '#/components/schemas/Cursor'
      required:
        - items
    ProblemDetails:
      description: A [RFC7807](https://www.rfc-editor.org/rfc/rfc7807) JSON Problem Details Object
      type: object
      properties:
        type:
          type: string
          description: A URI reference [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) to a URL, which, when dereferenced, provides human readable documentation for the problem type.  The problem type may be equivalent to the `status` or may be a "sub-type".  This URI is not intended to be parsed by clients; rather it should be treated as an opaque string that uniquely represents the error condition as-is.
          minLength: 1
        title:
          type: string
          description: A short, human-readable summary of the problem type.
          minLength: 1
        status:
          type: integer
          description: The HTTP status code ([RFC9110], Section 15) generated by the origin server for this occurrence of the problem.
          minLength: 1
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem.
          minLength: 1
        requestId:
          type: string
          description: |
            A unique identifier that is assigned to the request, either by the API caller or by the service itself.
          minLength: 1
      required:
        - type
        - title
        - status
        - detail
    ReferencesTreeItem:
      type: object
      properties:
        fieldName:
          description: Name of the field that contains the reference.
          type: string
        identifier:
          description: Identifier of the reference resource. Can be a UUID (Content Fragments), URN (Assets) or Path (Tag, Page, Experience Fragment).
          type: string
        referencesTree:
          description: List of child references for the current resource.
          type: array
          items:
            $ref: '#/components/schemas/ReferencesTreeItem'
      example:
        fieldName: location
        identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
        referencesTree:
          fieldName: locationPicture
          identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
          referencesTree: []
    BaseReference:
      type: object
      description: An information about referenced assets.
      discriminator:
        propertyName: type
        mapping:
          asset: '#/components/schemas/AssetReference'
          content-fragment: '#/components/schemas/ContentFragmentReference'
          page: '#/components/schemas/PageReference'
          tag: '#/components/schemas/TagReference'
      properties:
        type:
          description: Type of referenced object
          type: string
          enum:
            - content-fragment
            - asset
            - page
            - tag
      required:
        - type
    Path:
      type: string
      pattern: ^(?:(?!\*|\[|\]|\||\\|\|).)*$
      description: A valid path to a resource
      minLength: 1
    BaseReferenceProperties:
      description: A representation of base properties for a reference.
      type: object
      properties:
        name:
          description: Item name
          type: string
        title:
          type: string
          description: Reference title.
        path:
          $ref: '#/components/schemas/Path'
    AssetReference:
      description: Minimal information about referenced asset, can be used to generate preview.
      allOf:
        - $ref: '#/components/schemas/BaseReference'
        - type: object
          properties:
            value:
              allOf:
                - $ref: '#/components/schemas/BaseReferenceProperties'
                - type: object
                  properties:
                    assetId:
                      $ref: '#/components/schemas/URN'
                      description: Asset unique identifier expressed as a URN.
                    repo:size:
                      type: integer
                      format: int64
                      description: Asset size (bytes).
                    dc:format:
                      type: string
                      description: Asset mime type.
                    tiff:ImageWidth:
                      type: integer
                      format: int64
                      description: Asset width (if applicable).
                    tiff:ImageHeight:
                      type: integer
                      format: int64
                      description: Asset height (if applicable).
                    description:
                      type: string
                      description: Asset description.
                  required:
                    - assetId
    ContentFragmentReference:
      description: An information about referenced asset.
      allOf:
        - $ref: '#/components/schemas/BaseReference'
        - type: object
          properties:
            value:
              allOf:
                - $ref: '#/components/schemas/BaseReferenceProperties'
                - type: object
                  properties:
                    id:
                      $ref: '#/components/schemas/UUID'
                      description: Content fragment unique identifier.
                    description:
                      type: string
                      description: Content fragment description.
                    model:
                      $ref: '#/components/schemas/ContentFragmentModelIdentifier'
                    fields:
                      $ref: '#/components/schemas/ContentFragmentFields'
                  required:
                    - id
                    - path
                    - fields
    PageReference:
      description: Information about a referenced page.
      allOf:
        - $ref: '#/components/schemas/BaseReference'
        - type: object
          properties:
            value:
              allOf:
                - $ref: '#/components/schemas/BaseReferenceProperties'
              required:
                - path
    Tag:
      description: A representation of a tag.
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: Short tag ID.
        title:
          type: string
          description: Title that should be displayed instead of the tag name or tag id.
        i18n:
          description: Localised title and title path variants.
          type: array
          items:
            type: object
            properties:
              locale:
                type: string
                minLength: 2
                description: A RFC 5646 locale tag.
              title:
                type: string
                description: The localised title
              titlePath:
                type: string
                description: The localised title variant.
        titlePath:
          type: string
          description: Title variant of the tag ID.
        name:
          type: string
          description: Represents the node name.
        path:
          type: string
          description: Full absolute path of a tag.
        description:
          type: string
          description: Optional description for a tag.
      required:
        - id
        - i18n
    TagReference:
      description: A representation of the referenced tag.
      allOf:
        - $ref: '#/components/schemas/BaseReference'
        - type: object
          properties:
            value:
              allOf:
                - $ref: '#/components/schemas/Tag'
                  required:
                    - path
                - $ref: '#/components/schemas/BaseReferenceProperties'
    ContentFragmentModelPath:
      type: string
      minLength: 1
      description: A valid path to a Content Fragment Model resource.
      pattern: ^\/conf(\/.*)?$
    DataType:
      type: string
      description: Type of data stored in the field.
      enum:
        - text
        - long-text
        - number
        - float-number
        - date-time
        - date
        - time
        - boolean
        - enumeration
        - tag
        - content-fragment
        - content-reference
        - json
    ContentFragmentModelReference:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Base64URLId'
        path:
          $ref: '#/components/schemas/ContentFragmentModelPath'
          description: The path where this model is currently stored.X
        title:
          type: string
          minLength: 1
          description: The title of the Content Fragment Model.
        fields:
          type: object
          additionalProperties:
            type: object
            properties:
              type:
                $ref: '#/components/schemas/DataType'
      required:
        - id
        - path
        - title
      example:
        id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl
        path: /conf/wknd-shared/settings/dam/cfm/models/adventure
        title: Adventure
        fields:
          adventureName:
            type: text
          adventureDescription:
            type: long-text
          adventurePrice:
            type: long-number
          adventureStartDate:
            type: date
          adventureEndDate:
            type: date
          adventureLocation:
            type: content-reference
    ContentFragmentReferences:
      description: A representation of a Content Fragment.
      type: object
      properties:
        referencesTree:
          description: |
            The recursive hierarchical tree representing the references of a Content Fragment.
            The elements of the tree will contain only the `fieldName` where the reference is found, the `identifier`
            of the reference and the complete `referencesTree` of the reference, if that is the case.
            The first level will contain the fields of the Content Fragment.
            The `referencesTree` will always be present, but can be empty in the following cases:
              - the referenced Content Fragment doesn't contain any child references
              - the only references the fragment has are of type `asset`, `page` or `tag`.
          type: array
          items:
            $ref: '#/components/schemas/ReferencesTreeItem'
        references:
          description: |
            Provides the details of the references found in the `referencesTree` as a flat list.
            Each reference can be be accessed by its `identifier` from the `referencesTree`.
            The level of hydration will depend on the `references` request parameter.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/BaseReference'
        modelReferences:
          description: |
            Provides the details of the models used in the response as a flat list.
            Each model can be be accessed by its `identifier` found in each content fragment.
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ContentFragmentModelReference'
      required:
        - referencesTree
        - references
        - modelReferences
      example:
        referencesTree:
          - fieldName: profilePicture
            identifier: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
            referencesTree: []
          - fieldName: location
            identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
            referencesTree:
              fieldName: locationPicture
              identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              referencesTree: []
          - fieldName: addresses
            identifier: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            referencesTree: []
          - fieldName: addresses
            identifier: 679df962-6c16-4337-9cbd-1384f07eb9a7
            referencesTree: []
        references:
          urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62:
            type: asset
            value:
              name: ian_provo.jpg
              title: Ian Provo
              path: /content/dam/wknd-shared/en/contributors/ian_provo.jpg
              assetId: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: Ian Provo profile picture.
          046fc548-49e5-4ab7-82d8-3ff8b1ea679d:
            type: fragment-reference
            value:
              name: california
              title: California
              path: /content/dam/wknd-shared/en/locations/california
              id: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
              description: Best place for surfing.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
              fields:
                country: USA
                activities:
                  - Surfing
                  - Climbing
                locationPicture: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
                birthDay: '1988-09-26T14:09:00-07:00'
          urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e:
            type: asset
            value:
              name: california.jpg
              title: California
              path: /content/dam/wknd-shared/en/locations/california.jpg
              assetId: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: California location picture.
          98aaefe5-c4a5-4f26-80c5-22dcfca4a34c:
            type: fragment-reference
            value:
              name: ian-provo-home-address
              title: Ian Provo Home Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-home-address
              id: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
              description: Ian Provo home address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: 5th Street
                zipcode: '123322'
                town: New York
          679df962-6c16-4337-9cbd-1384f07eb9a7:
            type: fragment-reference
            value:
              name: ian-provo-work-address
              title: Ian Provo Work Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-work-address
              id: 679df962-6c16-4337-9cbd-1384f07eb9a7
              description: Ian Provo work address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: Elm Street
                zipcode: '892332'
                town: New York
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
    ContentFragmentResponse:
      description: A representation of a Content Fragment with references.
      allOf:
        - $ref: '#/components/schemas/ContentFragment'
        - $ref: '#/components/schemas/ContentFragmentReferences'
    ContentFragmentModel:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/Base64URLId'
        path:
          $ref: '#/components/schemas/ContentFragmentModelPath'
          description: The path where this model is currently stored.
        name:
          type: string
          minLength: 1
          description: The name of the Content Fragment Model Resource.
        title:
          type: string
          minLength: 1
          description: The title of the Content Fragment Model.
        description:
          type: string
          description: A human-readable description for this model.
        tags:
          type: array
          description: List of tags associated with this model.
          items:
            $ref: '#/components/schemas/Tag'
      required:
        - id
        - path
        - name
        - title
        - tags
      example:
        id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl
        path: /conf/wknd-shared/settings/dam/cfm/models/adventure
        name: adventure
        title: Adventure
        description: An adventure that can be booked by users.
        tags:
          - id: wknd-shared:season/summer
            title: Summer
            i18n: []
            titlePath: 'WKND Shared : Season / Summer'
            name: summer
            path: /content/cq:tags/wknd-shared/season/summer
            description: ''
          - id: wknd-shared:season/spring
            title: Spring
            i18n: []
            titlePath: 'WKND Shared : Season / Spring'
            name: spring
            path: /content/cq:tags/wknd-shared/season/spring
            description: ''
    ContentFragmentVariation:
      description: A representation of a Content Fragment Variation.
      type: object
      properties:
        name:
          type: string
          description: The name of the Content Fragment Variation.
        title:
          type: string
          minLength: 1
          description: The title of the Content Fragment Variation.
        description:
          type: string
          description: Content Fragment Variation description.
        model:
          $ref: '#/components/schemas/ContentFragmentModelIdentifier'
        fields:
          $ref: '#/components/schemas/ContentFragmentFields'
      required:
        - title
        - model
        - fields
    ContentFragmentVariationListResult:
      description: |
        Paginated collection of content fragment variations.
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ContentFragmentVariation'
        cursor:
          $ref: '#/components/schemas/Cursor'
      required:
        - items
    ContentFragmentVariationResponse:
      description: A representation of a Content Fragment Variation with references.
      allOf:
        - $ref: '#/components/schemas/ContentFragmentVariation'
        - $ref: '#/components/schemas/ContentFragmentReferences'
    ParentReference:
      type: object
      description: A parent reference for a Content Fragment.
      discriminator:
        propertyName: type
        mapping:
          content-fragment: '#/components/schemas/ParentContentFragmentReference'
          page: '#/components/schemas/ParentPageReference'
      properties:
        type:
          description: Type of parent reference
          type: string
          enum:
            - content-fragment
            - page
      required:
        - type
    ParentReferenceBaseProperties:
      description: A representation of page reference base properties.
      type: object
      properties:
        title:
          type: string
          description: Parent reference title
          minLength: 1
        path:
          $ref: '#/components/schemas/Path'
      required:
        - path
    ParentContentFragmentReference:
      description: An information about referenced content fragment.
      allOf:
        - $ref: '#/components/schemas/ParentReference'
        - type: object
          properties:
            value:
              allOf:
                - $ref: '#/components/schemas/ParentReferenceBaseProperties'
                - type: object
                  properties:
                    model:
                      $ref: '#/components/schemas/ContentFragmentModelIdentifier'
                    id:
                      $ref: '#/components/schemas/UUID'
                      description: Content Fragment unique identifier.
                  required:
                    - model
                    - id
    ParentPageReference:
      description: An information about parent referenced page.
      allOf:
        - $ref: '#/components/schemas/ParentReference'
        - $ref: '#/components/schemas/ParentReferenceBaseProperties'
      required:
        - path
    ParentReferencesList:
      type: object
      description: List of resources referencing the resource with the given `fragmentId`.
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ParentReference'
        cursor:
          $ref: '#/components/schemas/Cursor'
      required:
        - items
      example:
        items:
          - type: page
            value:
              path: /path/to/parent/page/reference
              title: Title
          - type: content-fragment
            value:
              path: /path/to/parent/content-fragment/reference
              title: Title
              model:
                id: L2NvbmYvZ2xvYmFsL3NldHRpbmdzL2RhbS9jZm0vbW9kZWxzL2Etc2ltcGxlLWNmbQ
              id: uuid-of-content-fragment
        cursor: wqeaszrdxtgfcyguiohfgytdrsewq
    ContentFragmentModelListResult:
      description: |
        Paginated collection of content fragment models.
      type: object
      properties:
        items:
          description: List of Content Fragment Models
          type: array
          items:
            $ref: '#/components/schemas/ContentFragmentModel'
        cursor:
          $ref: '#/components/schemas/Cursor'
      required:
        - items
    JsonSchema:
      type: object
      description: |
        A JSON Schema definition of the model fields.
        See https://json-schema.org/specification for the structure of the JSON Schema.
        The currently supported JSON Schema version is `2020-12`.
      example:
        $schema: https://json-schema.org/draft/2020-12/schema
        $id: /adobe/sites/cf/models/L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl
        title: Adventure
        description: An adventure product
        type: object
        properties:
          title:
            description: Title
            type: text
          slug:
            description: A short path to uniquely identify the Adventure. Can be used for pathing in client applications.
            type: text
          description:
            description: An overview of the trip.
            type: object
            properties:
              mimeType:
                description: Mime Type
                type: text
              value:
                description: Value
                type: text
          adventureType:
            description: Adventure Type
            type: array
            items:
              type: text
          tripLength:
            description: Trip Length
            type: text
          groupSize:
            description: Group size
            type: integer
          price:
            description: Price of the Adventure
            type: number
          primaryImage:
            description: Primary Image
            type: string
    HtmlContent:
      type: string
      description: Fully rendered HTML content
  parameters:
    cursor:
      in: query
      name: cursor
      description: |
        When the number of results for a request exceeds the allowed limit, the response will include a `cursor`.  That value can then be sent via this parameter on a subsequent request to retrieve the next set of items.
      schema:
        $ref: '#/components/schemas/Cursor'
    limit:
      in: query
      name: limit
      description: |
        For a paginated request, this parameter defines the maximum number of items to retrieve.
      schema:
        $ref: '#/components/schemas/Limit'
    If-None-Match:
      name: If-None-Match
      description: |
        The `If-None-Match` header field makes the request method conditional on a recipient cache or origin server either
        not having any current representation of the target resource, when the field value is "*", or having a selected
        representation with an entity tag that does not match any of those listed in the field value.

        For more details, please head over to [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-if-none-match).
      in: header
      required: false
      schema:
        type: string
    FragmentId:
      in: path
      name: fragmentId
      required: true
      schema:
        type: string
        minLength: 1
        description: |
          The fragment identifier can be either a UUID or a Base64URL encoded path.

          - UUID format: 8-4-4-4-12 hexadecimal digits separated by hyphens (e.g., 49af775d-0e7a-46c3-913d-00f762528373)
          - Base64URL format: URL-safe base64 encoding without padding, using only A-Z, a-z, 0-9, -, _ characters (e.g., L2NvbnRlbnQvZGFtL3drbmQtc2hhcmVkL2VuL2NvbnRyaWJ1dG9ycy9pYW4tcHJvdm8)
        pattern: ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|[A-Za-z0-9_-]+)$
    ReferencesOptional:
      in: query
      name: references
      required: false
      schema:
        type: string
        description: |
          This parameter defines how references will be retrieved for Content Fragments. The following options are available:
            * `none` - no references will be collected;
            * `direct` - only direct references will be collected; they will not be hydrated;
            * `direct-hydrated` - only direct references will be collected; they will be fully hydrated;
            * `all` - all references up to the maximum allowed depth will be collected; they will not be hydrated;
            * `all-hydrated` - all references up to the maximum allowed depth will be collected; they will be fully hydrated

          Non-hydrated responses will only include the properties defined by the `BaseReference` type when embedding references. 
          Hydrated responses are defined by each implementation of the `BaseReference` type. In particular, for
          Content Fragment references the response will include the fragment's fields and description.

          This parameter will affect the value of the ETag header returned with the response.

          Cannot be specified together with the `depth` or `hydrated` query parameters.
        enum:
          - none
          - direct
          - direct-hydrated
          - all
          - all-hydrated
        default: none
    Depth:
      in: query
      name: depth
      required: false
      schema:
        type: integer
        minimum: 0
        default: 0
        description: |
          The depth of the references to include in the response.
            
          A value of `0` will return the fragment without any references.
          A value of `1` will return the fragment with direct references.
          A value of `2` will return the fragment with direct references and their direct references and so on.
          The maximum value is configured by the system and may vary between implementations. The default max value is 10.
          Cannot be specified together with the `references` query parameter.
    Hydrated:
      in: query
      name: hydrated
      required: false
      schema:
        type: boolean
        default: false
        description: |
          This parameter defines if references will be retrieved for Content Fragments. The following options are available:
            * `true` - references will be populated;
            * `false` - references will not be populated.

          The default value is `false`. The verbosity of the output can be controlled through the `depth` parameter.
          Cannot be specified together with the `references` query parameter.
    FragmentPath:
      in: query
      name: path
      description: UTF-8 encoded parameter to specify an exact path to a Content Fragment.
      required: true
      schema:
        type: string
      examples:
        path-parameter:
          value: /content/dam/wknd-shared/en/contributors/ian-provo
          description: Get exactly one '/ian-provo' content fragment.
    References:
      in: query
      name: references
      required: false
      schema:
        type: string
        description: |
          This parameter defines how references will be retrieved for Content Fragments. The following options are available:
            * `direct` - only direct references will be collected; they will not be hydrated;
            * `direct-hydrated` - only direct references will be collected; they will be fully hydrated;
            * `all` - all references up to the maximum allowed depth will be collected; they will not be hydrated;
            * `all-hydrated` - all references up to the maximum allowed depth will be collected; they will be fully hydrated

          Non-hydrated responses will only include the properties defined by the `BaseReference` type when embedding references. 
          Hydrated responses are defined by each implementation of the `BaseReference` type. In particular, for
          Content Fragment references the response will include the fragment's fields and description.

          This parameter will affect the value of the ETag header returned with the response.
        enum:
          - direct
          - direct-hydrated
          - all
          - all-hydrated
        default: direct-hydrated
    VariationName:
      in: path
      name: variationName
      description: The name of the Content Fragment variation
      required: true
      schema:
        type: string
    FragmentModelId:
      in: path
      name: modelId
      description: The ID of the Content Fragment Model to retrieve.
      required: true
      schema:
        $ref: '#/components/schemas/Base64URLId'
    templateId:
      name: templateId
      in: path
      required: true
      schema:
        type: string
        minLength: 1
      description: |
        The template identifier used for rendering, or "generic_template" for default rendering.
      example: <template-id>
    fragmentId:
      name: fragmentId
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/UUID'
      description: |
        Unique identifier of the Content Fragment.
        This is the same fragmentId used when publishing the HTML fragment.
    variation:
      name: variation
      in: path
      required: true
      schema:
        type: string
        minLength: 1
      description: |
        The variation name of the Content Fragment that was rendered.
        Typically "main" for the primary variation, but can be any custom variation name.
      example: main
  responses:
    400_BadRequest:
      description: Bad Request. The Problem Details object will provide more information about the exact cause.
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/ProblemDetails'
              - type: object
                properties:
                  status:
                    type: integer
                    default: 400
                  title:
                    type: string
                    default: Bad Request
          example:
            type: http://api.adobeaemcloud.com/adobe/meta/errors/bad_request
            title: Bad Request
            status: 400
            detail: Bad request, please check that you have provided the correct parameters and that they are valid.
    406_Unacceptable:
      description: |
        Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
        according to the proactive negotiation header fields received in the request.
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/ProblemDetails'
              - type: object
                properties:
                  title:
                    type: string
                    example: Unacceptable
                  status:
                    type: integer
                    default: 406
          example:
            type: http://api.adobeaemcloud.com/adobe/meta/errors/not_acceptable
            title: Not Acceptable
            status: 406
            detail: |
              The target resource does not have a current representation that would be acceptable to the user agent, 
              according to the proactive negotiation header fields received in the request.
    500_InternalServerError:
      description: |
        The server encountered an unexpected error. Retrying the request after a certain time could help.
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/ProblemDetails'
              - type: object
                properties:
                  status:
                    type: integer
                    default: 500
                  title:
                    type: string
                    default: Internal Server Error
          example:
            type: http://api.adobeaemcloud.com/adobe/meta/errors/internal_server_error
            title: Internal Server Error
            status: 500
            detail: The server encountered an unexpected condition that prevented it from fulfilling the request.
    304_NotModified_ETag:
      description: Not Modified
      content: {}
      headers:
        ETag:
          $ref: '#/components/headers/ETag'
    404_NotFound:
      description: Not Found
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/ProblemDetails'
              - type: object
                properties:
                  status:
                    type: integer
                    default: 404
                  title:
                    type: string
                    default: Not Found
          example:
            type: http://api.adobeaemcloud.com/adobe/meta/errors/not_found
            title: Not Found
            status: 404
            detail: The requested resource could not be found.
    304_NotModified:
      description: Not Modified
      content: {}
      headers:
        ETag:
          $ref: '#/components/headers/ETag'
        Last-Modified:
          $ref: '#/components/headers/Last-Modified'
  headers:
    ETag:
      schema:
        type: string
      description: |
        The `ETag` field in a response provides the current entity tag for the selected representation, as determined at the
        conclusion of handling the request. An entity tag is an opaque validator for differentiating between multiple
        representations of the same resource, regardless of whether those multiple representations are due to resource state
        changes over time, content negotiation resulting in multiple representations being valid at the same time, or both.
        An entity tag consists of an opaque quoted string, possibly prefixed by a weakness indicator.

        For more details, please head over to [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-etag).
      required: true
    Last-Modified:
      schema:
        type: string
      description: |
        The "Last-Modified" header field in a response provides a timestamp indicating the date and time at which the origin
        server believes the selected representation was last modified, as determined at the conclusion of handling the
        request.

        For more details, please head over to [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-last-modified).
      required: true
  examples:
    ContentFragmentWithoutReferences:
      summary: Content Fragment without references
      value:
        id: 6d980e6a-c9e7-444b-af43-5503c46a061c
        path: /content/dam/wknd-shared/en/contributors/ian-provo
        name: ian-provo
        title: Ian Provo
        description: Watersports enthusiast and influencer.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree: []
        references: {}
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWR2ZW50dXJl
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    ContentFragmentWithReferencesNotHydrated:
      summary: Content Fragment with references not hydrated
      value:
        id: 6d980e6a-c9e7-444b-af43-5503c46a061c
        path: /content/dam/wknd-shared/en/contributors/ian-provo
        name: ian-provo
        title: Ian Provo
        description: Watersports enthusiast and influencer.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree:
          - fieldName: profilePicture
            identifier: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
            referencesTree: []
          - fieldName: location
            identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
            referencesTree:
              fieldName: locationPicture
              identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              referencesTree: []
          - fieldName: addresses
            identifier: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            referencesTree: []
          - fieldName: addresses
            identifier: 679df962-6c16-4337-9cbd-1384f07eb9a7
            referencesTree: []
        references:
          urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62:
            type: asset
            value:
              name: ian_provo.jpg
              title: Ian Provo
              path: /content/dam/wknd-shared/en/contributors/ian_provo.jpg
              assetId: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          046fc548-49e5-4ab7-82d8-3ff8b1ea679d:
            type: fragment-reference
            value:
              name: california
              title: California
              path: /content/dam/wknd-shared/en/locations/california
              id: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e:
            type: asset
            value:
              name: california.jpg
              title: California
              path: /content/dam/wknd-shared/en/locations/california.jpg
              assetId: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
          98aaefe5-c4a5-4f26-80c5-22dcfca4a34c:
            type: fragment-reference
            value:
              name: ian-provo-home-address
              title: Ian Provo Home Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-home-address
              id: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
          679df962-6c16-4337-9cbd-1384f07eb9a7:
            type: fragment-reference
            value:
              name: ian-provo-work-address
              title: Ian Provo Work Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-work-address
              id: 679df962-6c16-4337-9cbd-1384f07eb9a7
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    ContentFragmentWithReferencesHydrated:
      summary: Content Fragment with references hydrated
      value:
        id: 6d980e6a-c9e7-444b-af43-5503c46a061c
        path: /content/dam/wknd-shared/en/contributors/ian-provo
        name: ian-provo
        title: Ian Provo
        description: Watersports enthusiast and influencer.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree:
          - fieldName: profilePicture
            identifier: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
            referencesTree: []
          - fieldName: location
            identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
            referencesTree:
              fieldName: locationPicture
              identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              referencesTree: []
          - fieldName: addresses
            identifier: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            referencesTree: []
          - fieldName: addresses
            identifier: 679df962-6c16-4337-9cbd-1384f07eb9a7
            referencesTree: []
        references:
          urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62:
            type: asset
            value:
              name: ian_provo.jpg
              title: Ian Provo
              path: /content/dam/wknd-shared/en/contributors/ian_provo.jpg
              assetId: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: Ian Provo profile picture.
          046fc548-49e5-4ab7-82d8-3ff8b1ea679d:
            type: fragment-reference
            value:
              name: california
              title: California
              path: /content/dam/wknd-shared/en/locations/california
              id: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
              description: Best place for surfing.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
              fields:
                country: USA
                activities:
                  - Surfing
                  - Climbing
                locationPicture: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
                birthDay: '1988-09-26T14:09:00-07:00'
          urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e:
            type: asset
            value:
              name: california.jpg
              title: California
              path: /content/dam/wknd-shared/en/locations/california.jpg
              assetId: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: California location picture.
          98aaefe5-c4a5-4f26-80c5-22dcfca4a34c:
            type: fragment-reference
            value:
              name: ian-provo-home-address
              title: Ian Provo Home Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-home-address
              id: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
              description: Ian Provo home address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: 5th Street
                zipcode: '123322'
                town: New York
          679df962-6c16-4337-9cbd-1384f07eb9a7:
            type: fragment-reference
            value:
              name: ian-provo-work-address
              title: Ian Provo Work Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-work-address
              id: 679df962-6c16-4337-9cbd-1384f07eb9a7
              description: Ian Provo work address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: Elm Street
                zipcode: '892332'
                town: New York
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    ContentFragmentVariationWithoutReferences:
      summary: Content Fragment Variation without references
      value:
        name: mobile-variation
        title: Ian Provo Mobile
        description: Watersports enthusiast and influencer - Mobile.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Mobile Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree: []
        references: {}
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    ContentFragmentVariationWithReferencesNotHydrated:
      summary: Content Fragment with references hydrated
      value:
        name: mobile-variation
        title: Ian Provo Mobile
        description: Watersports enthusiast and influencer - Mobile.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Mobile Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree:
          - fieldName: profilePicture
            identifier: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
            referencesTree: []
          - fieldName: location
            identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
            referencesTree:
              fieldName: locationPicture
              identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              referencesTree: []
          - fieldName: addresses
            identifier: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            referencesTree: []
          - fieldName: addresses
            identifier: 679df962-6c16-4337-9cbd-1384f07eb9a7
            referencesTree: []
        references:
          urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62:
            type: asset
            value:
              name: ian_provo.jpg
              title: Ian Provo
              path: /content/dam/wknd-shared/en/contributors/ian_provo.jpg
              assetId: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          046fc548-49e5-4ab7-82d8-3ff8b1ea679d:
            type: fragment-reference
            value:
              name: california
              title: California
              path: /content/dam/wknd-shared/en/locations/california
              id: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e:
            type: asset
            value:
              name: california.jpg
              title: California
              path: /content/dam/wknd-shared/en/locations/california.jpg
              assetId: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
          98aaefe5-c4a5-4f26-80c5-22dcfca4a34c:
            type: fragment-reference
            value:
              name: ian-provo-home-address
              title: Ian Provo Home Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-home-address
              id: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
          679df962-6c16-4337-9cbd-1384f07eb9a7:
            type: fragment-reference
            value:
              name: ian-provo-work-address
              title: Ian Provo Work Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-work-address
              id: 679df962-6c16-4337-9cbd-1384f07eb9a7
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    ContentFragmentVariationWithReferencesHydrated:
      summary: Content Fragment with references hydrated
      value:
        name: mobile-variation
        title: Ian Provo Mobile
        description: Watersports enthusiast and influencer - Mobile.
        model:
          id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
        fields:
          firstName: Ian
          lastName: Provo
          profilePicture: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
          birthDay: '1988-09-26T14:09:00-07:00'
          biography:
            value: <p>Mobile Biography</p>
            mimeType: text/html
          occupations:
            - Influencer
            - Photographer
          location: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
          addresses:
            - 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            - 679df962-6c16-4337-9cbd-1384f07eb9a7
        referencesTree:
          - fieldName: profilePicture
            identifier: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
            referencesTree: []
          - fieldName: location
            identifier: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
            referencesTree:
              fieldName: locationPicture
              identifier: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              referencesTree: []
          - fieldName: addresses
            identifier: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
            referencesTree: []
          - fieldName: addresses
            identifier: 679df962-6c16-4337-9cbd-1384f07eb9a7
            referencesTree: []
        references:
          urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62:
            type: asset
            value:
              name: ian_provo.jpg
              title: Ian Provo
              path: /content/dam/wknd-shared/en/contributors/ian_provo.jpg
              assetId: urn:aaid:aem:1fb05fe4-c12b-4f85-b1ca-aa92cdbd6a62
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: Ian Provo profile picture.
          046fc548-49e5-4ab7-82d8-3ff8b1ea679d:
            type: fragment-reference
            value:
              name: california
              title: California
              path: /content/dam/wknd-shared/en/locations/california
              id: 046fc548-49e5-4ab7-82d8-3ff8b1ea679d
              description: Best place for surfing.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
              fields:
                country: USA
                activities:
                  - Surfing
                  - Climbing
                locationPicture: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
                birthDay: '1988-09-26T14:09:00-07:00'
          urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e:
            type: asset
            value:
              name: california.jpg
              title: California
              path: /content/dam/wknd-shared/en/locations/california.jpg
              assetId: urn:aaid:aem:301d7818-e648-4a2c-8b16-be0a29dd237e
              repo:size: 251434
              dc:format: image/jpeg
              tiff:ImageWidth: 1152
              tiff:ImageHeight: 1152
              description: California location picture.
          98aaefe5-c4a5-4f26-80c5-22dcfca4a34c:
            type: fragment-reference
            value:
              name: ian-provo-home-address
              title: Ian Provo Home Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-home-address
              id: 98aaefe5-c4a5-4f26-80c5-22dcfca4a34c
              description: Ian Provo home address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: 5th Street
                zipcode: '123322'
                town: New York
          679df962-6c16-4337-9cbd-1384f07eb9a7:
            type: fragment-reference
            value:
              name: ian-provo-work-address
              title: Ian Provo Work Address
              path: /content/dam/wknd-shared/en/addresses/ian-provo-work-address
              id: 679df962-6c16-4337-9cbd-1384f07eb9a7
              description: Ian Provo work address.
              model:
                id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYWRkcmVzcw==
              fields:
                street: Elm Street
                zipcode: '892332'
                town: New York
        modelReferences:
          L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y:
            id: L2NvbmYvd2tuZC1zaGFyZWQvc2V0dGluZ3MvZGFtL2NmbS9tb2RlbHMvYXV0aG9y
            path: /conf/wknd-shared/settings/dam/cfm/models/adventure
            title: Adventure
            fields:
              adventureName:
                type: text
              adventureDescription:
                type: long-text
              adventurePrice:
                type: long-number
              adventureStartDate:
                type: date
              adventureEndDate:
                type: date
              adventureLocation:
                type: content-reference
    html-fragment-response:
      summary: HTML Fragment response
      value: <!DOCTYPE html> <html> <head> <title>Sample Content Fragment</title> </head> <body> <h1>Product Title</h1> <p>This is the rendered content from the Content Fragment.</p> </body> </html>
