Skip to main content
Use the Knowledge Bases API to create, list, inspect, and delete knowledge bases. You can also delete an individual document from a knowledge base. Every request requires a workspace API key in the X-API-Key header.

List knowledge bases

GET /v1/knowledge-bases

Create knowledge base

POST /v1/knowledge-bases

Get knowledge base

GET /v1/knowledge-bases/{kbId}

Delete knowledge base

DELETE /v1/knowledge-bases/{kbId}

Delete document

DELETE /v1/knowledge-bases/{kbId}/documents/{docId}
The knowledge base status is derived from its documents: empty, processing, ready, or failed. Attach a knowledge base to an agent only after it is ready.