cURL
Folders
Create Folder
Create a knowledge base folder. Folders can be nested up to three levels deep by passing parent_id. Omitting parent_id creates a top-level folder.
POST
cURL
Documentation Index
Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
Available options:
2026-03-01 Example:
"2026-03-01"
Body
application/json
Response
Folder created.
The ID of the folder.
The ID of the parent folder, or null for top-level folders.
The folder's name.
When the folder was created.
Agents that have access to this folder.
Documents inside this folder.