Folders

Update Folder

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

patch/agents/folders/{id}

Request

Base URL
https://api.cartesia.ai
Auth
HTTP bearer
TypeScript
https://skmtc.dev/cartesia/apis/cartesia-api/docs/agents/folders/:id/patch.ts
A function with typed inputs. Its response is checked against the schema.

idstring required

The ID of the folder.

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

Example:2026-03-01

API version header.

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.

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.

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