v1

latestOpenAPI 3.1.02026-07-2671117149.2 KB
APIs
Folders

Create Folder

post/folders/create

Request body

folder_namestring required

Display name for the folder as it appears in your CAMB.AI workspace dashboard. Choose meaningful names that reflect the folder's purpose or project category, such as 'Marketing Audio Projects' or 'Podcast Transcriptions', to help you and your team quickly identify and navigate to the right organizational container for your tasks.

Response

Successful Response

statusstring

Indicates the outcome of the folder creation operation. Returns 'success' when the folder is created successfully, enabling your application to implement appropriate success handling, user notifications, and workflow continuation logic.

folder_idinteger

The unique identifier assigned to your newly created folder. This ID serves as the primary reference for all subsequent folder operations, including adding projects to the folder, retrieving folder contents, or managing folder permissions. Store this value for future API calls that require folder specification.

folder_namestring

The exact name assigned to your folder as stored in the system. This field confirms the final folder name after any processing, validation, or normalization that may have occurred during creation, ensuring your application displays the precise name that appears in CAMB.AI Studio and other system interfaces.

messagestring

Human-readable feedback about the folder creation operation. This field provides descriptive information suitable for displaying to users in success notifications, logging for debugging purposes, or integration with monitoring systems that track workspace organization activities.