v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB
Folders

Get folder details

Returns full details of a folder (metadata + aggregates like videos_count, storage_size, length, attached funnel and DRM groups).

get/folders/{folder_id}

Path parameters

folder_idstring uuid required

Unique identifier of the folder

Response

Folder details retrieved successfully

messagestring

Example response

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "My Video Folder",
    "user_id": "0fc88232-a673-42b1-9e6c-e974d9a937b7",
    "status": true,
    "created_at": "2025-08-01T10:30:00.000Z",
    "updated_at": "2025-08-01T10:30:00.000Z",
    "Videos": [
      {
        "id": "789e0123-e89b-12d3-a456-426614174000",
        "title": "Introduction Video",
        "video_external_id": "ext_video_123",
        "status": "READY",
        "created_at": "2025-08-01T10:30:00.000Z"
      }
    ],
    "funnel": {
      "id": "456e7890-e89b-12d3-a456-426614174000"
    },
    "drm_groups": [
      {
        "id": "321e4567-e89b-12d3-a456-426614174000",
        "name": "Premium Content Group",
        "status": true
      }
    ]
  },
  "message": "Success"
}