Skip to main content
POST
Bulk Create Documents

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

Cartesia-Version
enum<string>
default:2026-03-01
required

API version header.

Available options:
2026-03-01
Example:

"2026-03-01"

Body

application/json
documents
CreateDocumentBody · object[]
required

The documents to upload. Up to 100 per request.

Maximum array length: 100

Response

Documents created.

id
string
required

The ID of the document.

name
string | null
required

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

content
string
required

The full document text.

created_at
string<date-time>
required

When the document was uploaded.

metadata
object
required

User-defined string-keyed metadata.