Collections API

The Collections API allows you to browse the folder structure of your media library.

List Collections

Retrieves a list of collections (folders), either at the root level or within a specified parent collection.

GET /collections

Parameters

Name	Type	Required	Description
`path`	`string`	Optional	The full path of the parent collection (e.g., `root/movies`). Defaults to `root`.

Example Request

.http


GET /api/client/v1/collections?path=root/fitness
Host: https://your-app.com
Authorization: Bearer sk-your-api-key-here

Example Response: 200 OK


{
  "data": [
    {
      "name": "Yoga Sessions",
      "path": "root/fitness/yoga-sessions"
    },
    {
      "name": "HIIT Workouts",
      "path": "root/fitness/hiit-workouts"
    }
  ]
}