{
  "openapi": "3.0.1",
  "info": {
    "title": "DAM Assets API",
    "description": "Use the DAM Assets API to search for digital assets by full-text, visual, and/or filtered criteria. Keys and operators are entity and definition-derived string values. See the [DAM Context API](/dam/context-api) for how to discover the keys, filterability, and operators available in your tenant.\n{% admonition type=\"warning\" name=\"Early Access\" %}\n    This API is currently available as Early Access. \n    The API and its documentation may be updated as we continue to develop the \n    capability and incorporate feedback. Endpoints, schemas, and behavior \n    may change before General Availability.\n{% /admonition %}\n## Authentication\n\nTo use this API, you need:\n\n- The hostname of your Content Hub server, without `https://` or a trailing slash. You can get this from your Content Hub administrator. Use it as the `server` variable in the request URL.\n- An access token, sent with every request as `Authorization: Bearer <token>`. Obtain the token using your client's supported [authentication flow](https://doc.sitecore.com/ch/en/developers/cloud-dev/oauth-tokens.html#grant-flows).\n",
    "version": "v1.0",
    "x-metadata": {
      "product": [
        "SitecoreAI",
        "Content Hub"
      ],
      "category": "Discover DAM assets"
    },
    "license": {
      "name": "closed source",
      "url": "https://www.sitecore.com"
    }
  },
  "servers": [
    {
      "url": "https://{server}",
      "variables": {
        "server": {
          "default": "your-server"
        }
      }
    }
  ],
  "security": [
    {
      "OAuth2": []
    }
  ],
  "tags": [
    {
      "name": "DAM Assets",
      "description": "Search for DAM assets."
    }
  ],
  "paths": {
    "/api/v1/dam/assets/search": {
      "post": {
        "tags": [
          "DAM Assets"
        ],
        "summary": "Find assets by text, image or filters",
        "description": "Executes a full-text, visual, and/or filtered search over DAM assets and returns matching assets with the requested fields, taxonomies, relations, and renditions. \n\nUse filterable keys and operators that can be discovered with the [DAM Context API](/dam/context-api). For taxonomy and relation filters, use entity `identifier` strings, not numeric IDs or labels. In `include`, use exact key names in their matching section, such as `taxonomies` or `relations`, and `*` is not valid. \n\nThe [DAM Context API](/dam/context-api) lists the accepted keys for each section.  Request taxonomy values through `include.taxonomies`. Use taxonomy filters  to select assets by membership.  `total` counts all matches, while `items` contains the page selected by `skip` and `take`.\n\nTaxonomy filters can match values that are not listed in the expanded taxonomy entry. Use an `anyOf` relation filter to find assets linked to  any of the supplied entity identifiers. Full-text search is not an exact  tag-membership test; use the tag taxonomy key to filter for tagged assets.\n\nUse `usageRights` for a permitted-use scenario, with dates in YYYY-MM-DD. Constraints are ANDed within the same combined rights profile; `anyOf` requires at least one listed value, not every value. Omitted constraints are unchecked. Check `capabilities.usageRights` and the advertised keys using the [DAM Context API](/dam/context-api)  before requesting it.\n\n`thumbnailUrl` is always returned when the asset has a thumbnail. `renditions` contains only the rendition keys listed in `include.renditions`; list `thumbnail` there to also receive it under `renditions`. Search returns rendition URLs; dimensions and file size are returned only by asset detail.",
        "operationId": "searchDamAssets",
        "requestBody": {
          "description": "The DAM asset search request payload.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DamSearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DamSearchResponse"
                }
              }
            }
          },
          "400": {
            "description": "Facade validation failures use ErrorResponse. Framework model-state failures use a parameter-to-messages dictionary. USAGE_RIGHTS_UNAVAILABLE (category unsupported, not retryable) means a usageRights scenario was requested while capabilities.usageRights is false. Recover via the [DAM Context API](/dam/context-api).  An invalid usage-rights key, operator, identifier, date or constraint returns UNKNOWN_FILTER, UNSUPPORTED_OPERATOR or INVALID_VALUE with the full parameter path, for example `usageRights.constraints[0].values[0]`.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelStateValidationErrors"
                }
              }
            }
          },
          "401": {
            "description": "Handled by existing authentication before endpoint access checks. These endpoints do not define or change the authentication error body."
          },
          "403": {
            "description": "Access denied after successful authentication. Never returned for a malformed request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited by the platform throttling middleware when throttling is enabled for the environment. The body is a plain-text message, not an ErrorResponse. Retry after the `Retry-After` header.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "Internal error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "503": {
            "description": "Visual search unavailable, or the service is temporarily unable to serve the request. A failure that prevents applying a requested usageRights scenario returns SERVICE_UNAVAILABLE, never unfiltered results.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OAuth2": []
          }
        ]
      }
    },
    "/api/v1/dam/assets/{id}": {
      "get": {
        "tags": [
          "DAM Assets"
        ],
        "summary": "Get a DAM asset by ID",
        "description": "Retrieves a single DAM asset by its entity ID with core members and independently selected fields, taxonomies, relations, renditions and expansions. Each omitted selector returns its full caller-visible section; a present but empty selector loads none of that section. Selecting one section does not change the defaults of the others. `fields` selects entries in the response `fields` map, as in search. With no selectors, the response is fully hydrated.",
        "operationId": "getDamAssetById",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Asset entity ID.",
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 1
            }
          },
          {
            "name": "culture",
            "in": "query",
            "required": false,
            "description": "Culture/language code used to localize multilingual returned values, for example `en-US`. Defaults to the caller's preferred culture, falling back to `en-US`.",
            "schema": {
              "type": "string",
              "nullable": true
            }
          },
          {
            "name": "fields",
            "in": "query",
            "required": false,
            "description": "Comma-separated canonical field keys from context, matching search include.fields and returned in the response fields map. Omitted returns all visible fields; fields= loads none and returns fields as an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE. Core members remain present.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "uniqueItems": true,
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "taxonomies",
            "in": "query",
            "required": false,
            "description": "Comma-separated canonical taxonomy keys from context, matching search include.taxonomies. Omitted returns all visible taxonomy members; taxonomies= loads none and returns an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "uniqueItems": true,
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "relations",
            "in": "query",
            "required": false,
            "description": "Comma-separated canonical relation keys from context, matching search include.relations. Omitted returns all visible relation members; relations= loads none and returns an empty map. Does not change other selectors. Unknown, invisible, misplaced or repeated keys return 400 UNKNOWN_INCLUDE. CollectionToAsset memberships belong in collections.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "uniqueItems": true,
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "renditions",
            "in": "query",
            "required": false,
            "description": "Comma-separated configured rendition keys, matching search include.renditions. Omitted selects all configured renditions; renditions= loads none and returns an empty map. Does not change other selectors. Unknown or repeated keys return 400 UNKNOWN_INCLUDE; configured keys unavailable for this asset are omitted from the map.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "uniqueItems": true,
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "expansions",
            "in": "query",
            "required": false,
            "description": "Comma-separated on-demand sections that are not asset members: publicLinks, collections. Omitted returns every available expansion; expansions= loads and returns none. Does not change other selectors. Unknown or repeated values return 400 UNKNOWN_INCLUDE.",
            "style": "form",
            "explode": false,
            "schema": {
              "type": "array",
              "uniqueItems": true,
              "items": {
                "$ref": "#/components/schemas/AssetExpansion"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DamAssetDetails"
                }
              }
            }
          },
          "400": {
            "description": "Facade validation failures use ErrorResponse. Framework model-state failures use a parameter-to-messages dictionary. UNKNOWN_INCLUDE for an unknown, invisible, misplaced or repeated selector value.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ModelStateValidationErrors"
                }
              }
            }
          },
          "401": {
            "description": "Handled by existing authentication before endpoint access checks. These endpoints do not define or change the authentication error body."
          },
          "403": {
            "description": "Access denied after successful authentication. Never returned for a malformed request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "The asset does not exist or is not visible to the caller.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited by the platform throttling middleware when throttling is enabled for the environment. The body is a plain-text message, not an ErrorResponse. Retry after the `Retry-After` header.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "500": {
            "description": "Internal error.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "OAuth2": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "ModelStateValidationErrors": {
        "type": "object",
        "additionalProperties": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "description": "Framework validation errors keyed by request parameter path."
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "status",
          "code"
        ],
        "description": "Problem Details error response with Sitecore extension members.  `code` and `category` appear at the top level, not inside an error object.",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`."
          },
          "title": {
            "type": "string",
            "description": "Stable per `code`."
          },
          "status": {
            "type": "integer"
          },
          "detail": {
            "type": "string",
            "description": "Occurrence-specific explanation."
          },
          "instance": {
            "type": "string",
            "description": "The request path that produced this occurrence."
          },
          "code": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]*$",
            "description": "Stable identifier. Never reworded or renumbered once shipped. Search validation codes: `INVALID_VALUE`, `UNKNOWN_FILTER`, `NOT_FILTERABLE`, `UNSUPPORTED_OPERATOR`, `UNRESOLVED_FILTER`, `UNKNOWN_INCLUDE`, `UNKNOWN_SORT`, `NOT_VISUALLY_INDEXED`, and `USAGE_RIGHTS_UNAVAILABLE`. GET-by-ID validation uses `INVALID_VALUE` or `UNKNOWN_INCLUDE`; missing or invisible assets return `ASSET_NOT_FOUND`. Search service failures use `VISUAL_SEARCH_UNAVAILABLE` or `SERVICE_UNAVAILABLE`. Unhandled endpoint failures use `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately."
          },
          "category": {
            "type": "string",
            "enum": [
              "auth",
              "precondition",
              "not_found",
              "ambiguous",
              "validation",
              "conflict",
              "policy",
              "unsupported"
            ],
            "description": "Omitted for timeout, rate-limit, dependency, or internal failures."
          },
          "requiredNextStep": {
            "type": "object",
            "required": [
              "operationId",
              "method",
              "href",
              "reason"
            ],
            "description": "A suggested API request to resolve the error, when available. Invalid taxonomy values link to the corresponding taxonomy-value lookup. Usage-rights availability and other validation failures link to the [DAM Context API](/dam/context-api). An invalid asset ID links to asset search.",
            "properties": {
              "operationId": {
                "type": "string"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET",
                  "POST",
                  "PUT",
                  "PATCH",
                  "DELETE"
                ]
              },
              "href": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              }
            }
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Parameter name to human-readable messages."
          },
          "invalidParams": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "parameter": {
                  "type": "string"
                },
                "value": {
                  "type": "string",
                  "nullable": true,
                  "description": "The offending value as received, when applicable."
                },
                "reason": {
                  "type": "string",
                  "enum": [
                    "no_match",
                    "ambiguous",
                    "wrong_taxonomy",
                    "unparseable",
                    "operator_not_supported",
                    "not_filterable",
                    "out_of_range"
                  ]
                },
                "candidates": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "traceId": {
            "type": "string"
          }
        }
      },
      "DamSearchRequest": {
        "type": "object",
        "properties": {
          "query": {
            "$ref": "#/components/schemas/DamSearchQuery"
          },
          "filters": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetFilter"
            },
            "description": "Inclusion criteria; results must match these filter conditions. Entries are ANDed together; values within each entry follow the selected operator.",
            "default": []
          },
          "exclusions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AssetFilter"
            },
            "description": "Exclusion criteria; results matching these conditions are filtered out. Supported operators are `anyOf`, `exists`, `greaterThan`, and `lessThan`; `allOf` and `between` are not supported in exclusions.",
            "default": []
          },
          "include": {
            "$ref": "#/components/schemas/AssetInclude"
          },
          "usageRights": {
            "$ref": "#/components/schemas/UsageRights"
          },
          "sorting": {
            "$ref": "#/components/schemas/AssetSorting"
          },
          "culture": {
            "type": "string",
            "nullable": true,
            "description": "Culture/language code used to localize multilingual returned values, for example `en-US`. Defaults to the caller's preferred culture, falling back to `en-US`."
          },
          "skip": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "minimum": 0,
            "description": "Number of matching results to skip (paging offset).",
            "default": 0
          },
          "take": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "minimum": 1,
            "maximum": 100,
            "description": "Maximum number of results to return (page size). Maximum allowed is `100`.",
            "default": 10
          }
        },
        "description": "Request for searching DAM asset content with various criteria."
      },
      "UsageRights": {
        "type": "object",
        "additionalProperties": false,
        "description": "Optional permitted-use scenario, ANDed with ordinary filters and exclusions. Unrestricted assets qualify; restricted assets require no explicit approval and one combined profile covering the dates and supplied constraints. Omitted dimensions are unchecked; `{}` checks today's date only, and omitting `usageRights` performs no rights check. No administrator bypass or download authorization. Requires capabilities.usageRights; otherwise returns 400 USAGE_RIGHTS_UNAVAILABLE (unsupported).",
        "properties": {
          "start": {
            "type": "string",
            "format": "date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "example": "2026-11-01",
            "description": "First day, inclusive. Defaults to today's UTC date. Historical dates are allowed; timestamps are rejected."
          },
          "end": {
            "type": "string",
            "format": "date",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "example": "2026-11-30",
            "description": "Last day, inclusive, on or after start. Defaults to the effective start."
          },
          "constraints": {
            "type": "array",
            "default": [],
            "items": {
              "$ref": "#/components/schemas/UsageRightsConstraint"
            },
            "description": "ANDed within the same combined profile as the dates. Each key occurs at most once."
          }
        },
        "example": {
          "start": "2026-11-01",
          "end": "2026-11-30",
          "constraints": [
            {
              "key": "territories",
              "operator": "anyOf",
              "values": [
                "territory-germany",
                "territory-france"
              ]
            },
            {
              "key": "media",
              "operator": "allOf",
              "values": [
                "media-online"
              ]
            }
          ]
        }
      },
      "UsageRightsConstraint": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "key",
          "operator",
          "values"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Canonical key from context usageRights.constraints, not an ordinary asset filter key."
          },
          "operator": {
            "type": "string",
            "enum": [
              "allOf",
              "anyOf"
            ],
            "description": "allOf requires every value; anyOf requires at least one. Multiple constraints can use anyOf, but each must use a different key."
          },
          "values": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            },
            "description": "Visible canonical taxonomy identifiers of the key's taxonomy, not IDs or labels. Parent coverage includes descendants, not vice versa."
          }
        }
      },
      "AssetSorting": {
        "type": "object",
        "required": [
          "field"
        ],
        "properties": {
          "field": {
            "type": "string",
            "description": "A sortable context key or `modified_on`. `id` is not supported."
          },
          "direction": {
            "type": "string",
            "enum": [
              "asc",
              "desc"
            ],
            "default": "asc",
            "description": "Sort direction."
          }
        },
        "description": "If no `sorting` is provided, requests containing a full-text (`query.text`) or visual (`query.visual`) search are sorted by relevance; all other requests are sorted by `modified_on` descending."
      },
      "DamSearchQuery": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "nullable": true,
            "description": "Free-text query string used to search across indexed content."
          },
          "visual": {
            "$ref": "#/components/schemas/VisualQuery"
          }
        },
        "description": "Retrieval inputs used to rank search results."
      },
      "VisualQuery": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "asset",
              "image",
              "color",
              "text"
            ],
            "default": "asset",
            "description": "Type of visual search to execute: `asset` (reuse a stored asset's embedding), `image` (absolute HTTP or HTTPS URL), `color` (hex value), or `text` (phrase describing appearance)."
          },
          "value": {
            "type": "string",
            "description": "Input value for visual search: an asset ID, an absolute HTTP or HTTPS URL, a hex color, or a text phrase."
          }
        },
        "required": [
          "value"
        ],
        "description": "Visual search input payload (mode + value)."
      },
      "AssetFilter": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "description": "Context key to evaluate. The key must have `filterable: true` in the DAM Context response."
          },
          "operator": {
            "type": "string",
            "enum": [
              "anyOf",
              "allOf",
              "between",
              "greaterThan",
              "lessThan",
              "exists"
            ],
            "default": "anyOf",
            "description": "Operator to apply for the filter criterion."
          },
          "values": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The number of values depends on the operator. Supply one or more  values for `anyOf` or `allOf`, two values for between  (minimum and maximum, both inclusive), and one value for `greaterThan`  or `lessThan`. Omit values for `exists`. In filters, exists selects  assets with a value. In exclusions, it selects assets without a value.\nFor taxonomy and relation filters, use entity `identifier` strings  rather than numeric IDs or display labels.\nUse ISO 8601 dates where possible. For date-times, include `Z`  or an explicit timezone offset. Dates without a timezone can also  be accepted. Other formats depend on the server's regional settings,  not the request's culture. Values that cannot be parsed return  `400 INVALID_VALUE`."
          }
        },
        "required": [
          "key"
        ],
        "description": "A filter condition used to evaluate data based on a specified member, operator, and values."
      },
      "AssetInclude": {
        "type": "object",
        "properties": {
          "fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Canonical field member names to include in response items."
          },
          "taxonomies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Canonical taxonomy member names to include in response items."
          },
          "relations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Canonical relation member names to include in response items."
          },
          "renditions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "default": [],
            "description": "Rendition keys to include in response items."
          }
        },
        "description": "Optional response expansion selections for asset search results."
      },
      "AssetExpansion": {
        "type": "string",
        "enum": [
          "publicLinks",
          "collections"
        ],
        "description": "On-demand section of GET by ID. publicLinks reads existing links and never creates one."
      },
      "DamSearchResponse": {
        "type": "object",
        "properties": {
          "culture": {
            "type": "string",
            "nullable": true,
            "description": "Effective culture used to localize returned values."
          },
          "skip": {
            "type": "integer",
            "format": "int32",
            "description": "Number of items skipped."
          },
          "take": {
            "type": "integer",
            "format": "int32",
            "description": "Requested number of items."
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Count of all matches across all pages, not the length of items."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DamAssetSearchItem"
            },
            "description": "Current page of matching assets. Use `skip` and `take` to retrieve additional pages."
          }
        },
        "description": "The response for DAM asset search."
      },
      "EntityRef": {
        "type": "object",
        "required": [
          "id",
          "identifier"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Related entity ID."
          },
          "identifier": {
            "type": "string",
            "description": "Canonical related entity identifier."
          },
          "label": {
            "type": "string",
            "nullable": true,
            "description": "Display label resolved from the configured display-template properties.  Multilingual properties use the effective culture with `en-US` fallback;  invariant properties use their stored value. Null when no display text can be resolved."
          }
        }
      },
      "DamAssetSearchItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Asset entity ID."
          },
          "identifier": {
            "type": "string",
            "description": "Asset identifier."
          },
          "title": {
            "type": "string",
            "nullable": true,
            "description": "Asset display title."
          },
          "fileName": {
            "type": "string",
            "nullable": true,
            "description": "Asset file name."
          },
          "assetType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset type identifier and localized label."
          },
          "mediaType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset media type identifier and localized label."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "nullable": true,
            "description": "Asset file size in bytes."
          },
          "width": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "description": "Asset width in pixels."
          },
          "height": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "description": "Asset height in pixels."
          },
          "createdOn": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Asset creation timestamp."
          },
          "lifecycleStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset lifecycle status identifier and localized label."
          },
          "thumbnailUrl": {
            "type": "string",
            "nullable": true,
            "description": "Primary thumbnail URL for the asset. Always returned when the asset has a thumbnail, independent of `include.renditions`."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Asset description."
          },
          "fields": {
            "type": "object",
            "additionalProperties": {},
            "description": "Custom property values requested in `include.fields`, keyed by the exact member key requested. Multilingual values are resolved to the effective culture and are omitted when that culture has no value; other values keep their stored JSON type. A requested key the asset does not carry is omitted. Empty when `include.fields` is not sent."
          },
          "taxonomies": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntityRef"
              }
            },
            "description": "Requested taxonomy values keyed by canonical member name."
          },
          "relations": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntityRef"
              }
            },
            "description": "Related entity references grouped by canonical relation key."
          },
          "renditions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/DamAssetSearchRendition"
            },
            "description": "Rendition metadata keyed by rendition name, limited to the keys requested in `include.renditions`. `thumbnail` appears here only when requested; `thumbnailUrl` carries its URL either way."
          }
        },
        "description": "DAM asset search result entry. Core members are present; `id` and `identifier` are non-null, while unavailable nullable core values are returned as null. Expansion dictionaries may be empty; unavailable rendition keys are omitted."
      },
      "DamAssetDetails": {
        "type": "object",
        "required": [
          "culture",
          "id",
          "identifier",
          "fields",
          "taxonomies",
          "relations",
          "renditions"
        ],
        "properties": {
          "culture": {
            "type": "string",
            "description": "Effective culture used to localize returned values."
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Asset entity ID."
          },
          "identifier": {
            "type": "string",
            "description": "Asset identifier."
          },
          "title": {
            "type": "string",
            "nullable": true,
            "description": "Asset display title."
          },
          "fileName": {
            "type": "string",
            "nullable": true,
            "description": "Asset file name."
          },
          "assetType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset type identifier and localized label."
          },
          "mediaType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset media type identifier and localized label."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "nullable": true,
            "description": "Asset file size in bytes."
          },
          "width": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "description": "Asset width in pixels."
          },
          "height": {
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "description": "Asset height in pixels."
          },
          "createdOn": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Asset creation timestamp."
          },
          "lifecycleStatus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EntityRef"
              },
              {
                "type": "object",
                "nullable": true,
                "enum": [
                  null
                ]
              }
            ],
            "description": "Asset lifecycle status identifier and localized label."
          },
          "thumbnailUrl": {
            "type": "string",
            "nullable": true,
            "description": "Primary thumbnail URL for the asset. Always returned when the asset has a thumbnail, independent of the `renditions` selector."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Asset description."
          },
          "fields": {
            "type": "object",
            "additionalProperties": {},
            "description": "Custom property and option-list values keyed by member name. Defaults to all visible fields; the `fields` query parameter narrows it and an empty value returns an empty map. Multilingual values are resolved to the  effective culture and are omitted when that culture has no value;  other values keep their stored JSON type. Members the asset carries  no value for are omitted."
          },
          "taxonomies": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntityRef"
              }
            },
            "description": "Taxonomy values keyed by canonical taxonomy key. Defaults to all visible taxonomy members; the `taxonomies` query parameter narrows it and an empty value returns an empty map. A taxonomy the asset has no value for is omitted from the map."
          },
          "relations": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EntityRef"
              }
            },
            "description": "Related entities keyed by canonical relation key. Defaults to all visible relation members; the `relations` query parameter narrows it and an empty value returns an empty map. The `CollectionToAsset` relation is never returned here; it is the `collections` expansion."
          },
          "renditions": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/DamAssetSearchRendition"
            },
            "description": "Rendition metadata keyed by configured rendition name. Defaults to all configured renditions; the `renditions` query parameter narrows it and an empty value returns an empty map. A configured rendition that is unavailable for this asset is omitted, so the map may be empty. `thumbnail` appears here only when the tenant configures it; `thumbnailUrl` carries its URL either way."
          },
          "publicLinks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DamPublicLink"
            },
            "description": "Existing completed, enabled and non-expired public links to the asset. Present when the `publicLinks` expansion is selected (the default); empty when the asset has none."
          },
          "collections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EntityRef"
            },
            "description": "Caller-visible `CollectionToAsset` memberships. Present when the `collections` expansion is selected (the default); empty when none are visible."
          }
        },
        "description": "DAM asset detail with independently selected sections and always-present core members. `culture`, `id` and `identifier` are non-null, while unavailable nullable core values are returned as null. Omitted selectors retain full hydration; empty member selectors return empty maps, and `expansions=` omits all expansion sections. Fields, taxonomies and relations are limited to caller-visible context members. System-owned, automation and AI-suggestion members excluded from context are also excluded here. Configured renditions may be absent when unavailable for this asset."
      },
      "DamPublicLink": {
        "type": "object",
        "required": [
          "relativeUrl"
        ],
        "properties": {
          "relativeUrl": {
            "type": "string",
            "description": "Public-link path relative to the Content Hub origin, not a gateway routing prefix."
          },
          "expiresOn": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "resourceName": {
            "type": "string",
            "nullable": true
          }
        },
        "description": "Existing non-expired public link to an asset."
      },
      "DamAssetSearchRendition": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "nullable": true,
            "description": "Delivery URL for the rendition."
          },
          "width": {
            "type": "integer",
            "format": "int32",
            "description": "Rendition width in pixels. Returned only by asset detail, omitted from search results."
          },
          "height": {
            "type": "integer",
            "format": "int32",
            "description": "Rendition height in pixels. Returned only by asset detail, omitted from search results."
          },
          "fileSize": {
            "type": "integer",
            "format": "int64",
            "description": "Rendition file size in bytes. Returned only by asset detail, omitted from search results."
          }
        },
        "description": "Rendition payload for DAM search responses."
      }
    },
    "securitySchemes": {
      "OAuth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://{server}/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  }
}