Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cartesia Knowledge Base API

Documents and folders used by agents.

Cartesia Knowledge Base API is one of 21 APIs that Cartesia publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Knowledge Base. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 11 operations across 5 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 2026-03-01.

Requests are made against a single base URL, https://api.cartesia.ai.

11 operations 5 paths 4 schemas 2 DELETE4 GET2 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2026-03-01
Base URL
https://api.cartesia.ai
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

Cartesia Knowledge Base API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (sk_car_... API key or short-lived access token) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Cartesia API key (skcar...) or a short-lived access token minted via POST /access-token, passed as Authorization: Bearer . Every request also requires the Cart…

Paths & Operations 11

Across 5 paths, the API surfaces 11 operations — 2 DELETE, 4 GET, 2 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Knowledge Base 11

Documents and folders used by agents.

GET
/documents
List Documents
listDocuments 1 param → 200401
POST
/documents
Create Document
createDocument 1 param body → 200401422
POST
/documents/bulk
Bulk Create Documents
bulkCreateDocuments 1 param body → 200401422
GET
/documents/{id}
Get Document
getDocument 2 params → 200401404
PATCH
/documents/{id}
Update Document
updateDocument 2 params body → 200401404
DELETE
/documents/{id}
Delete Document
deleteDocument 2 params → 200401404
GET
/folders
List Folders
listFolders 1 param → 200401
POST
/folders
Create Folder
createFolder 1 param body → 200401422
GET
/folders/{id}
Get Folder
getFolder 2 params → 200401404
PATCH
/folders/{id}
Update Folder
updateFolder 2 params body → 200401404
DELETE
/folders/{id}
Delete Folder
deleteFolder 2 params → 200401404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Error (6 properties), Document (5 properties), Folder (4 properties), DeleteResponse (2 properties). Each schema is shown below with its type and property counts.

Folder
object
4 properties
DeleteResponse
object
2 properties
Document
object
5 properties
Error
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cartesia-ai-knowledge-base-api-openapi.yml Raw ↑

Other APIs Cartesia publishes across the network.

Cartesia TTS WebSocket API
Cartesia STT WebSocket API
Cartesia Agents API
Cartesia API Keys API
Cartesia Auth API
Cartesia Calls API
Cartesia Datasets API
Cartesia Deployments API
Cartesia Infill API
Cartesia Metrics API
Cartesia Phone Numbers API
Cartesia Pronunciation Dictionaries API