v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB
Folders

Update Folder

Update a knowledge base folder's name, parent, documents, or agents

patch/agents/folders/{id}

Path parameters

idstring required

The ID of the folder.

Headers

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

API version header.

Request body

namestring

A new name for the folder. Must be unique among siblings.

parent_idstring nullable

Move the folder under a new parent, or null to move it to the top level. Cannot create a circular reference.

Response

Folder updated.

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.