v1

latestOpenAPI 3.1.02026-07-24650272.2 KB

API Endpoints

Create Folder

Create a folder inside a video workspace. Optionally provide parent_id to create a nested folder.

post/video/workspaces/{workspace_id}/folders

Path parameters

workspace_idstring required

Video workspace id.

Request body

namestring required

Folder name.

parent_idstring nullable

Parent folder id. Send null or omit it to create a root-level folder.

Response

200

idstring

namestring

video_source_idstring

parent_idstring nullable

pathstring[]

path_namesstring[]

depthinteger

subdirectory_countinteger

asset_countinteger

created_atstring

updated_atstring

Example response

{
  "id": "67e4f01d403562dbea6542d4",
  "name": "Course Assets",
  "video_source_id": "67e4ece9403562dbea65425f",
  "path": [
    "67e4f01d403562dbea6542d4"
  ],
  "path_names": [
    "Course Assets"
  ],
  "subdirectory_count": 2,
  "asset_count": 12,
  "created_at": "2026-03-18T10:00:00.000Z",
  "updated_at": "2026-03-18T10:15:00.000Z"
}