# Retrieve searchable DAM asset context

Retrieves the taxonomies, fields, data sources, relations, renditions, and usage-rights dimensions available for DAM asset search and response expansion, derived from the `M.Asset` definition, localized to the requested culture. This context covers asset members only.
The `include` parameter accepts the following parameters:
- `taxonomies`
- `fields`
- `dataSources`
- `relations`
- `renditions`
- `usageRights`

If the `include` parameter is omitted, the response contains taxonomy  metadata and instance capabilities. Request additional sections explicitly,  for example `include=taxonomies,fields`. To retrieve all sections, specify  `taxonomies,fields,dataSources,relations,renditions,usageRights`.  Request only the sections you need to limit response size. Before  filtering assets by usage rights, check that `capabilities.usageRights`  is `true` and request the `usageRights` section to discover supported dimensions.

Endpoint: GET /api/v1/dam/assets/context
Version: v1.0
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2

## Query parameters:

  - `culture` (string)
    Culture/language code used to localize labels, for example `en-US`. Accepts a single culture code. Defaults to the caller's preferred culture, falling back to `en-US`.

  - `include` (array)
    Section names to return, sent as one comma-separated value, for example `include=taxonomies,fields`. Omitted or empty returns `taxonomies` only; name every section to receive all of them. An unknown name returns `400 UNKNOWN_INCLUDE` with the offending value and the valid names in `invalidParams`.

## Response 200:

  - `200` (unknown)
    Successful operation

## Response 200 fields (application/json):

  - `culture` (string)
    The culture used to localize the returned context, for example `en-US`.

  - `include` (array, required)
    Contains the effective section selection. Defaults to taxonomies when  the request's include parameter is omitted.

  - `taxonomies` (array)
    Taxonomies available for filtering or expanding assets. Absent when not selected by `include`.

  - `taxonomies.key` (string)
    Canonical taxonomy key used by search filters, sorting, and response expansion.

  - `taxonomies.definitionName` (string)
    The taxonomy's entity definition name, for example `M.PCM.Market`.

  - `taxonomies.label` (string)
    The taxonomy's label in the requested culture.

  - `taxonomies.multiValue` (boolean)
    Whether the taxonomy allows multiple values.

  - `taxonomies.filterable` (boolean)
    Whether this taxonomy key can be used in filters and exclusions.

  - `taxonomies.hierarchical` (boolean)
    Whether the taxonomy is hierarchical.

  - `taxonomies.sortable` (boolean)
    Whether this key can be used as a sort field.

  - `taxonomies.operators` (array)
    Operators supported for this taxonomy key.

  - `fields` (array)
    Fields available for filtering or expanding assets. Absent when not selected by `include`.

  - `fields.key` (string)
    Canonical field key used by search filters, sorting, and response expansion.

  - `fields.label` (string)
    The field's label in the requested culture.

  - `fields.dataType` (string)
    The field's data type, for example `string`, `integer`, `long`, or `datetime`.

  - `fields.multiValue` (boolean)
    Whether the field allows multiple values.

  - `fields.multiLanguage` (boolean)
    Whether the field is multilingual.

  - `fields.filterable` (boolean)
    Whether this field key can be used in filters and exclusions.

  - `fields.sortable` (boolean)
    Whether this key can be used as a sort field.

  - `fields.operators` (array)
    Operators supported for this field key.

  - `dataSources` (array)
    Data sources available for filtering or expanding assets. Absent when not selected by `include`.

  - `dataSources.key` (string)
    Canonical data-source key used by response expansion and, when filterable, search filters.

  - `dataSources.filterable` (boolean)
    Whether this data-source key can be used in filters and exclusions.

  - `dataSources.name` (string)
    The data source's name. Retrieve its values with `GET /api/datasources/{name}` (`operationId: getDataSourceByName`).

  - `dataSources.operators` (array)
    Operators supported for this data-source key.

  - `dataSources.sortable` (boolean)
    Whether this data-source key can be used as a sort field. Option-list string keys are not sortable.

  - `relations` (array)
    Relations available for filtering or expanding assets. Absent when not selected by `include`.

  - `relations.key` (string)
    Canonical relation key used by response expansion and, when filterable, search filters.

  - `relations.definitionName` (string)
    The related entity definition name.

  - `relations.label` (string)
    The relation's label in the requested culture.

  - `relations.multiValue` (boolean)
    Whether the relation allows multiple values.

  - `relations.filterable` (boolean)
    Whether this relation key can be used in filters and exclusions.

  - `relations.selfRelation` (boolean)
    Whether the relation targets the same entity definition as the asset.

  - `relations.sortable` (boolean)
    Whether this key can be used as a sort field.

  - `relations.operators` (array)
    Operators supported for this relation key.

  - `renditions` (array)
    Renditions available for asset response expansion. Absent when not selected by `include`.

  - `renditions.key` (string)
    Canonical rendition key used for response expansion, for example `Preview` or `Thumbnail`.

  - `renditions.filterable` (boolean)
    Whether this rendition key can be used in filters and exclusions. Renditions are not filterable.

  - `renditions.mediaTypes` (array)
    Asset-media entity identifiers associated with this rendition.

  - `usageRights` (object)
    Usage-rights dimensions a scenario can constrain. Absent when not selected by `include`. Selected but unavailable returns an empty `constraints` array. Dimensions omitted from a scenario are not checked. When `capabilities.usageRights` is true, a scenario can filter by dates only even if no dimensions are advertised.

  - `usageRights.constraints` (array, required)
    Configured taxonomy dimensions visible to the caller. Empty when usage rights are unavailable or no dimension is advertised.

  - `usageRights.constraints.key` (string)
    Configured usage-rights key used to submit values for this dimension.

  - `usageRights.constraints.definitionName` (string)
    Taxonomy definition name. Pass it as `name` to `listTaxonomyValues` and submit the returned identifiers.

  - `usageRights.constraints.label` (string)
    The dimension's label in the requested culture. Display metadata only; not a filter value.

  - `usageRights.constraints.hierarchical` (boolean)
    Whether the taxonomy is hierarchical.

  - `usageRights.constraints.operators` (array)
    Operators supported for this dimension.

  - `capabilities` (object)

  - `capabilities.visualSearch` (boolean)
    Whether visual search is enabled for this instance.

  - `capabilities.imageTagging` (boolean)
    Whether image tagging is enabled for this instance.

  - `capabilities.usageRights` (boolean)
    Whether usage-rights scenarios are available for this instance. Always returned.

## Response 400:

  - `400` (unknown)
    Facade validation failures use ErrorResponse. Framework model-state failures use a parameter-to-messages dictionary.

## Response 400 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Context validation returns `INVALID_VALUE` for an invalid culture or `UNKNOWN_INCLUDE` for an unknown section. Unhandled endpoint failures return `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    The single best recovery call, if one exists.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

## Response 401:

  - `401` (unknown)
    Handled by existing authentication before endpoint access checks. This endpoint does not define or change the authentication error body.

## Response 403:

  - `403` (unknown)
    Access denied after successful authentication. Never returned for a malformed request.

## Response 403 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Context validation returns `INVALID_VALUE` for an invalid culture or `UNKNOWN_INCLUDE` for an unknown section. Unhandled endpoint failures return `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    The single best recovery call, if one exists.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

## Response 429:

  - `429` (unknown)
    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.

## Response 429 headers (text/plain):

  - `Retry-After` (integer)
    Seconds to wait before retrying.

## Response 500:

  - `500` (unknown)
    Internal error.

## Response 500 fields (application/problem+json):

  - `type` (string)
    Generic RFC 7231 status-code reference, shared across codes. Never branch on this; branch on `code`.

  - `title` (string)
    Stable per `code`.

  - `status` (integer, required)

  - `detail` (string)
    Occurrence-specific explanation.

  - `instance` (string)
    The request path that produced this occurrence.

  - `code` (string, required)
    Stable identifier. Never reworded or renumbered once shipped. Context validation returns `INVALID_VALUE` for an invalid culture or `UNKNOWN_INCLUDE` for an unknown section. Unhandled endpoint failures return `INTERNAL_ERROR`. Authentication, authorization, and platform throttling errors are handled separately.

  - `category` (string)
    Omitted for timeout, rate-limit, dependency, or internal failures.
    Enum: "auth", "precondition", "not_found", "ambiguous", "validation", "conflict", "policy", "unsupported"

  - `requiredNextStep` (object)
    The single best recovery call, if one exists.

  - `requiredNextStep.operationId` (string, required)

  - `requiredNextStep.method` (string, required)
    Enum: "GET", "POST", "PUT", "PATCH", "DELETE"

  - `requiredNextStep.href` (string, required)

  - `requiredNextStep.reason` (string, required)

  - `errors` (object)
    Parameter name to human-readable messages.

  - `invalidParams` (array)

  - `invalidParams.parameter` (string)

  - `invalidParams.value` (string)
    The offending value as received, when applicable.

  - `invalidParams.reason` (string)
    Enum: "no_match", "ambiguous", "wrong_taxonomy", "unparseable", "operator_not_supported"

  - `invalidParams.candidates` (array)

  - `traceId` (string)

