v1

latestOpenAPI 3.1.02026-07-2416666272.6 KB

Folders

Create new folder

Creates a folder. Use parent_folder_id to nest, omit it for a root-level folder.

post/folders

Request body

namestring required

Folder name

parent_folder_idstring uuid nullable

Parent folder ID for creating nested folders

Example request

{
  "name": "My Video Folder"
}

Response

Folder created 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"
  },
  "message": "Created"
}