API referenceKnowledge bases
List the organization’s knowledge bases
Each with its derived status, document count and size. Status is computed, not stored: a base is empty, indexing, ready or error based on what its last build did.
Requires the read scope. A key with less gets 403 insufficient_scope.
AuthorizationBearer <token>
Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/knowledge-bases"{ "data": [ { "agentCount": 2, "chunkCount": 187, "compiledTokens": 0, "createdAt": "2026-08-25T09:14:22Z", "deliveryMode": "inline", "description": "Delivery timelines, COD rules and the returns window.", "docCount": 4, "error": null, "id": "9f1c2d84-4e3a-4f6c-b902-7d1e8a33c451", "name": "Shipping and returns policy", "status": "empty", "totalBytes": 248311, "updatedAt": "2026-08-25T09:14:22Z" } ]}Was this page helpful?