DAM public reads contract

Complete HTTP contract for public folders, media search, facets, and shareable-link reads.

Updated: Apr 26, 2026

Use this contract when you need exact endpoint paths, methods, parameters, request bodies, responses, schemas, and status codes.

Public contract file: /swagger/dam-api.json

Use the operation pages for implementation guidance and this contract file for exact HTTP details.

Operation identity

When an operation page says the OpenAPI contract does not document an Operation ID, cite the stable operation key instead. Stable operation keys use the API, HTTP method, and path, so they identify an endpoint without pretending the contract publishes an operationId.

Registered routes

Use this API-first route list when you already know the owning API and need to find the exact operation page. Routes are grouped by resource so Management, Shopper, Auth, DAM, and Integrations operations stay distinct.

Folders

GET /api/v1/\{app_id\}/folders/\{id\} - Get folder by id
GET /api/v1/\{app_id\}/folders/\{id\}/media - Get Folder Contents
GET /api/v1/\{app_id\}/folders/\{id\}/facets - Get Folder Facets
GET /api/v1/\{app_id\}/folders/\{id\}/tree - Get Folder Tree from Path
GET /api/v1/\{app_id\}/folders/tree - Get Full Folder Tree
GET /api/v1/\{app_id\}/folders/public - Get Public Folders

Media

GET /api/v1/\{app_id\}/folders/\{folder_id\}/media/\{media_id\} - Get Media Item by ID
GET /api/v1/\{app_id\}/media/search - Search Media

Shareable Links

GET /api/v1/\{app_id\}/shareable-links/\{token\}/folder/\{folder_id\}/media - Get Shareable Link Folder Media
GET /api/v1/\{app_id\}/shareable-links/\{token\}/folders - Get Shareable Link Folders
GET /api/v1/\{app_id\}/shareable-links/\{token\}/media - Get Shareable Link Media

DAM public reads contract

# DAM public reads contract Use this contract when you need exact endpoint paths, methods, parameters, request bodies, responses, schemas, and status codes. - Public contract file: /swagger/dam-api.json Use the operation pages for implementation guidance and this contract file for exact HTTP details. ## Operation identity When an operation page says the OpenAPI contract does not document an Operation ID, cite the stable operation key instead. Stable operation keys use the API, HTTP method, and path, so they identify an endpoint without pretending the contract publishes an operationId. ## Registered routes Use this API-first route list when you already know the owning API and need to find the exact operation page. Routes are grouped by resource so Management, Shopper, Auth, DAM, and Integrations operations stay distinct. ### Folders - GET /api/v1/{app_id}/folders/{id} - [Get folder by id](/reference/folders/get-folder-by-id) - GET /api/v1/{app_id}/folders/{id}/media - [Get Folder Contents](/reference/folders/get-folder-contents) - GET /api/v1/{app_id}/folders/{id}/facets - [Get Folder Facets](/reference/folders/get-folder-facets) - GET /api/v1/{app_id}/folders/{id}/tree - [Get Folder Tree from Path](/reference/folders/get-folder-tree-from-path) - GET /api/v1/{app_id}/folders/tree - [Get Full Folder Tree](/reference/folders/get-full-folder-tree) - GET /api/v1/{app_id}/folders/public - [Get Public Folders](/reference/folders/get-public-folders) ### Media - GET /api/v1/{app_id}/folders/{folder_id}/media/{media_id} - [Get Media Item by ID](/reference/media/get-media-item-by-id) - GET /api/v1/{app_id}/media/search - [Search Media](/reference/media/search-media) ### Shareable Links - GET /api/v1/{app_id}/shareable-links/{token}/folder/{folder_id}/media - [Get Shareable Link Folder Media](/reference/shareable-links/get-shareable-link-folder-media) - GET /api/v1/{app_id}/shareable-links/{token}/folders - [Get Shareable Link Folders](/reference/shareable-links/get-shareable-link-folders) - GET /api/v1/{app_id}/shareable-links/{token}/media - [Get Shareable Link Media](/reference/shareable-links/get-shareable-link-media)