Returns every attribute available on media within a folder, with distinct-item counts. The returned filter_key on each facet can be passed back to Get Folder Contents as part of attributes= to filter the listing. Per-template exclusion: when computing counts for a facet, filters on that same template_key are ignored; filters on other templates still apply. This matches the OR-within-template / AND-across-template filter semantics so users can multi-select within a template and still see realistic counts for the other values.

API ownership

• API family: DAM public reads
• Best for: Public asset-library folder, media, facet, and shareable-link reads. Use Management API DAM routes for authenticated administration.
• Guide route: /media/dam/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: GET
• Path: /api/v1/\{app_id\}/folders/\{id\}/facets
• Summary: Get Folder Facets
• Description: Returns every attribute available on media within a folder, with distinct-item counts. The returned filter_key on each facet can be passed back to Get Folder Contents as part of attributes= to filter the listing. Per-template exclusion: when computing counts for a facet, filters on that same template_key are ignored; filters on other templates still apply. This matches the OR-within-template / AND-across-template filter semantics so users can multi-select within a template and still see realistic counts for the other values.
• OpenAPI contract: dam-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "data": [
    {
      "active": false,
      "count": 0,
      "description": "string",
      "filter_key": "string",
      "key": "string",
      "name": "string",
      "template_key": "string",
      "values": [
        {
          "count": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "success": false
}

{
  "details": [
    "string"
  ],
  "error": "string"
}

{
  "details": [
    "string"
  ],
  "error": "string"
}

{
  "details": [
    "string"
  ],
  "error": "string"
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: DAM public reads
• Method: GET
• Path: /api/v1/\{app_id\}/folders/\{id\}/facets
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Folders
• OpenAPI summary: Get Folder Facets