Documents

Create Document

Upload a document into a knowledge base folder

post/agents/documents

Headers

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

Example:2026-03-01

API version header.

folder_idstring required

The folder to upload the document into.

contentstring required

The document text. Maximum 1 MB.

namestring nullable

An optional display name for the document.

metadataobject

User-defined string-keyed metadata. Used to filter retrieval at query time.

Document created.

idstring required

The ID of the document.

namestring nullable required

The document's display name, or null if unnamed.

contentstring required

The full document text.

created_atstring date-time required

When the document was uploaded.

metadataobject required

User-defined string-keyed metadata.