Get Folder Contents - Enad

GET

api

{app_id}

folders

{id}

contents

Error

A valid request URL is required to generate request examples

{
  "data": [
    {
      "alt_text": "<string>",
      "attributes": [
        {
          "description": "<string>",
          "id": "<string>",
          "key": "<string>",
          "name": "<string>",
          "values": {}
        }
      ],
      "blurhash": "<string>",
      "copyright": "<string>",
      "created_at": "<string>",
      "custom": [
        123
      ],
      "description": "<string>",
      "file_type": "<string>",
      "folder": {
        "id": "<string>",
        "name": "<string>",
        "public": true,
        "slug": "<string>"
      },
      "id": "<string>",
      "status": "<string>",
      "title": "<string>",
      "translations": {},
      "type": "<string>",
      "updated_at": "<string>",
      "url": "<string>",
      "variants": [
        {
          "created_at": "<string>",
          "format": "<string>",
          "height": 123,
          "id": "<string>",
          "updated_at": "<string>",
          "url": "<string>",
          "width": 123
        }
      ]
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "success": true
}

Path Parameters

app_id

string

required

App ID

string

required

Folder ID

Query Parameters

page

integer

Page number (default: 1)

per_page

integer

Items per page (default: 20, max: 100)

type

string

Filter by type: image, video, file, all (default: all)

sort_by

string

Sort field: name, created_at, updated_at, type (default: created_at)

sort_order

string

Sort order: asc, desc (default: desc)

attributes

string[]

Filter by attribute(s). Repeat the query parameter once per filter, each in the form template_key/attribute_key. Filters sharing the same template_key combine with OR; distinct template_keys combine with AND. Example: ?attributes=color/red&attributes=color/blue&attributes=size/large

Response

Folder contents

data

object[]

Show child attributes

pagination

object

Show child attributes

success

boolean

Get Folder FacetsReturns 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.

Error

A valid request URL is required to generate request examples

{
  "data": [
    {
      "alt_text": "<string>",
      "attributes": [
        {
          "description": "<string>",
          "id": "<string>",
          "key": "<string>",
          "name": "<string>",
          "values": {}
        }
      ],
      "blurhash": "<string>",
      "copyright": "<string>",
      "created_at": "<string>",
      "custom": [
        123
      ],
      "description": "<string>",
      "file_type": "<string>",
      "folder": {
        "id": "<string>",
        "name": "<string>",
        "public": true,
        "slug": "<string>"
      },
      "id": "<string>",
      "status": "<string>",
      "title": "<string>",
      "translations": {},
      "type": "<string>",
      "updated_at": "<string>",
      "url": "<string>",
      "variants": [
        {
          "created_at": "<string>",
          "format": "<string>",
          "height": 123,
          "id": "<string>",
          "updated_at": "<string>",
          "url": "<string>",
          "width": 123
        }
      ]
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total_items": 123,
    "total_pages": 123
  },
  "success": true
}