GET/1.0/knowledge-bases

Lists every knowledge base the key's workspace can see. Required scope: workbench:knowledge_bases:read (scopes reference).

Response

{
  "knowledgeBases": [
    {
      "id": "kb_...",
      "kbUuid": "6f9d...",
      "name": "Support docs",
      "description": "Refund + shipping policies",
      "recipe": "docs",
      "status": "ready",
      "sourceCount": 12,
      "chunkCount": 340,
      "sizeBytes": 482304,
      "embeddingModel": "openai/text-embedding-3-small",
      "visibility": "WORKSPACE",
      "createdAt": "2026-07-01T09:00:00.000Z",
      "updatedAt": "2026-07-04T09:00:00.000Z"
    }
  ]
}

status is one of empty · ingesting · ready · failed. embeddingModel is null before the first ingestion.

Use an id with POST /1.0/knowledge-bases/:id/search to retrieve content, or GET /1.0/knowledge-bases/:id for the full record.