Update Folder
Update a knowledge base folder’s name, parent, documents, or agents. All fields are optional. Passing documents or agents replaces the full set — send an empty array to remove everything.
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.
2026-03-01 "2026-03-01"
Path Parameters
The ID of the folder.
Body
Fields to update on a folder. All fields are optional. Passing documents or agents replaces the full set — send an empty array to detach all documents or agents.
A new name for the folder. Must be unique among siblings.
1Move the folder under a new parent, or null to move it to the top level. Cannot create a circular reference.
The complete set of documents that should be in this folder. Documents not in the list are deleted. Pass an empty array to delete all documents in the folder.
The complete set of agents that have access to this folder. Agents not in the list have their access revoked. Pass an empty array to revoke access for all agents.
Response
Folder updated.
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.