BRbraiv
Folders

Create a folder or subfolder

Creates a Studio folder in the bound personal or workspace library. Omit parentId for a root folder. Nesting is limited to 3 levels. The reserved name All Videos cannot be created or used as a parent. Required scope: videos:write.

post/folders

Request

  • Base URL
    https://api.braiv.co/v1
  • Auth
    • HTTP bearer
    • or API key in header X-Api-Key

Headers

Idempotency-Keystring

Caller-generated key for safe POST retries. The API retains the first JSON response for 24 hours. Reusing a key with another path or body returns 409 IDEMPOTENCY_REPLAY.

Request body

namestring required

Folder display name. All Videos is reserved.

parentIdstring

Existing folder id in the same library. Omit to create a root folder. Max nesting is 3 levels.

Response

Folder created.

idstring required

Studio folder id. Pass as folderId on createVideo.

namestring required

Display name.

parentIdstring nullable required

Parent folder id, or null at the library root.

pathstring[] required

Ancestor names from the root through this folder.

workspaceIdstring

Present when the folder belongs to a workspace library.

Changes

No recorded changes to this operation across all 1 revision of this API.