v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB
Folders

Create Folder

Create a knowledge base folder

post/agents/folders

Headers

Cartesia-Version'2026-03-01' date required
Example:2026-03-01

API version header.

Request body

namestring required

A human-readable name for the folder. Must be unique among siblings.

parent_idstring nullable

ID of the parent folder. Omit or pass null to create a top-level folder. Folders can be nested at most three levels deep.

Response

Folder created.

idstring required

The ID of the folder.

parent_idstring nullable required

The ID of the parent folder, or null for top-level folders.

namestring required

The folder's name.

created_atstring date-time required

When the folder was created.