Skip to content
Esc
↑↓navigate↵open⌘Jpreview

Get folder media

Lists media (images, videos, files) in a folder with pagination, sorting, attribute filtering and full-text search. Returns matching items plus attribute-based facet counts.

GET/api/v2/{team_slug}/{app_slug}/dam/folders/{folder_id}/media
Authorization
AuthorizationBearer token · headerrequired

Management API token, sent as Authorization: Bearer <token>.

Path parameters
team_slugstringrequired
app_slugstringrequired
folder_idstring<uuid>required
Query parameters
pageinteger
per-pageinteger
typestring[]

Filter by media type: image, video, file. Repeatable.

statusstring

Filter by status: active, inactive, draft, pending

searchstring
sort-keystring

Sort key: name, created_at, updated_at, type, rank (default created_at). rank requires search

sort-orderstring

Sort order: asc, desc (default desc)

attributestring[]

Attribute filter as 'template_key/attribute_key'. Repeatable.

Responses
200

OK

dataMediaItem[]required
Show properties
Array of MediaItem
idUUIDrequired
typestringrequired
Allowed:imagevideofile
urlstringrequired
titlestring | null
statusstringrequired
descriptionstring | null
blurhashstring | null
publicbooleanrequired
folderFolderRef | null
Show properties
Any of:
FolderRef
idUUIDrequired
namestringrequired
slugstringrequired
null
null
created_atstring<date-time>required
updated_atstring<date-time> | null
facetsMediaFacet[]required
Show properties
Array of MediaFacet
template_keystringrequired
template_namestringrequired
valuesMediaFacetValue[]required
Show properties
Array of MediaFacetValue
keystringrequired
namestringrequired
countintegerrequired
activebooleanrequired
total_pagesintegerrequired
total_itemsintegerrequired
400

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
401

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
403

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
404

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
500

Request-level failure

errorErrorBodyrequired
Show properties
messagestringrequired
detailsstring[]required
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://api.enad.io/api/v2/string/string/dam/folders/497f6eca-6276-4993-bfeb-53cbbbba6f08/media' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'
Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "type": "image",
      "url": "string",
      "title": "string",
      "status": "string",
      "description": "string",
      "blurhash": "string",
      "public": true,
      "folder": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "slug": "string"
      },
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "facets": [
    {
      "template_key": "string",
      "template_name": "string",
      "values": [
        {
          "key": "string",
          "name": "string",
          "count": 0,
          "active": true
        }
      ]
    }
  ],
  "total_pages": 0,
  "total_items": 0
}