Skip to main content
DELETE
Delete Knowledge Base
Destructive
v1 only. Knowledge bases are available on the /v1 API. There is no legacy unversioned equivalent.
Soft-delete a knowledge base. DialNexa blocks the delete while the knowledge base is still attached to the current draft or latest published version of any agent in the workspace. The delete is reversible by support within the retention window.

When to use this

  • Retiring content: remove a knowledge base whose content is obsolete so agents stop answering from it.
  • Multi-tenant offboarding: delete a per-customer knowledge base when that customer leaves.
Before deleting, check which agents reference the knowledge base and update their knowledge_base_ids via Update Agent if they should switch to a replacement. If any agent still uses the knowledge base, the API returns 409 Conflict with the affected agent_ids. A 404 Not Found means the knowledge base does not exist in this workspace. See Errors for the standard error format.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

Knowledge base deleted successfully.

success
boolean
Example:

true

message
string
Example:

"Knowledge base deleted successfully"