Documents

Create Document

Upload a document into a knowledge base folder

post/agents/documents

Request

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

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.

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