Skip to main content
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.
  2. Populate its content through the supported dashboard ingestion flow.
  3. Attach it with Update Agent.
  4. Get or list resources to confirm the signed ID and name.
  5. Rename without changing attachments.
  6. 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 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.