List Folders

Retrieve all gallery folders for the current workspace.

Method

GET /v1/gallery/folders

Headers

Authorization · string

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

Request Example

cURL

curl "https://api.voyantcloud.com/v1/gallery/folders" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response

200 OK

{
  "data": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "workspaceId": "ws_abc",
      "name": "Marketing",
      "parentId": null,
      "path": "Marketing",
      "createdAt": "2025-01-05T12:00:00.000Z",
      "updatedAt": "2025-01-05T12:00:00.000Z"
    },
    {
      "id": "22222222-2222-2222-2222-222222222222",
      "workspaceId": "ws_abc",
      "name": "Campaigns",
      "parentId": "11111111-1111-1111-1111-111111111111",
      "path": "Marketing/Campaigns",
      "createdAt": "2025-02-01T08:00:00.000Z",
      "updatedAt": "2025-02-01T08:00:00.000Z"
    }
  ]
}

Folders are returned flat. Use parentId and path to build a tree structure on the client.