> ## Documentation Index
> Fetch the complete documentation index at: https://docs.persistence.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Bases API

> Create and manage knowledge bases through the public API.

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.

<CardGroup cols={2}>
  <Card title="List knowledge bases" href="/api-reference/knowledge-bases/list">`GET /v1/knowledge-bases`</Card>
  <Card title="Create knowledge base" href="/api-reference/knowledge-bases/create">`POST /v1/knowledge-bases`</Card>
  <Card title="Get knowledge base" href="/api-reference/knowledge-bases/get">`GET /v1/knowledge-bases/{kbId}`</Card>
  <Card title="Delete knowledge base" href="/api-reference/knowledge-bases/delete">`DELETE /v1/knowledge-bases/{kbId}`</Card>
  <Card title="Delete document" href="/api-reference/knowledge-bases/delete-document">`DELETE /v1/knowledge-bases/{kbId}/documents/{docId}`</Card>
</CardGroup>

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`.