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

# Knowledge Base overview

> Create, attach, rename, list, and safely retire v1 knowledge bases.

Knowledge bases hold reusable context for agent versions. The v1 API manages the resource record; attach its signed `kb_` ID to an agent version through `knowledge_base_ids`.

## Lifecycle

1. [Create a knowledge base](/docs/api-reference/v1/knowledge-base/create).
2. Populate its content through the supported dashboard ingestion flow.
3. Attach it with [Update Agent](/docs/api-reference/v1/agents/update).
4. [Get](/docs/api-reference/v1/knowledge-base/get) or [list](/docs/api-reference/v1/knowledge-base/list) resources to confirm the signed ID and name.
5. [Rename](/docs/api-reference/v1/knowledge-base/update) without changing attachments.
6. Detach it from agent versions before [deleting](/docs/api-reference/v1/knowledge-base/delete).

## Response envelope

`GET /v1/knowledge-base` returns `items` plus a `meta` object with `totalItems`, `itemsPerPage`, `totalPages`, and `currentPage`. See [Pagination](/docs/api-reference/pagination) for an endpoint-by-endpoint envelope table.

## Delete conflicts

Deletion is blocked while a current draft or latest published agent version references the knowledge base. Use the affected agent IDs in the `409 Conflict` response to detach or replace the knowledge base, then retry the delete.