Knowledge Base overview - DialNexa Documentation

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

Capabilities

Capability	Operation
Create, list, read, rename and delete knowledge bases	Create, List, Get, Update, Delete
Add a PDF, TXT or DOCX document	Upload Knowledge Base Document
List documents and check indexing	List Knowledge Base Documents

Lifecycle

Create a knowledge base.
Add documents with Upload Knowledge Base Document and wait until List Knowledge Base Documents shows each one ready. A document whose indexing fails is removed from that list instead; upload it again.
Attach it with Update Agent.
Get or list resources to confirm the signed ID and name.
Rename without changing attachments.
Detach it from agent versions before deleting.

Response envelope

GET /v1/knowledge-base returns items plus a meta object with totalItems, itemsPerPage, totalPages, and currentPage. See API 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. The 409 Conflict response lists those agents in data.agent_ids (with data.code KNOWLEDGE_BASE_IN_USE); detach or replace the knowledge base on each, then retry the delete.