Skip to main content

​
Overview

Delete an existing Knowledge Base along with all of its associated documents. Once deleted, the Knowledge Base can no longer be attached to AI agents, and its documents will no longer be available for retrieval.
Warning: This action is permanent and cannot be undone.

​
Prerequisites

  • Bearer token for an authenticated workspace
  • Valid Knowledge Base ID

​
Request

​
string
required
Bearer token for authenticated workspace access.
​
string
required
Unique identifier of the Knowledge Base to delete.

​
Response

​
Response Fields

​
boolean
Indicates whether the request completed successfully.
​
integer
HTTP status code returned by the API.
​
string
Confirmation that the Knowledge Base has been permanently deleted.

​
Error Handling

Deleting a Knowledge Base permanently removes:
  • The Knowledge Base itself.
  • All uploaded documents.
  • Any embeddings or indexed data created from those documents.
  • Any future AI agent access to the deleted Knowledge Base.
This action cannot be reversed.
Related endpoints:
  • GET /api/knowledgeBase — List all Knowledge Bases.
  • GET /api/knowledgeBase/{knowledgeBaseId} — Retrieve Knowledge Base details.
  • GET /api/knowledgeBase/{knowledgeBaseId}/documents — View all documents.
  • PUT /api/knowledgeBase/{knowledgeBaseId} — Update the Knowledge Base.
  • POST /api/knowledgeBase/createKnowledgeBase — Create a new Knowledge Base.