DocumentationAPI ReferenceChangelog

Envocal API

API Reference API Changelog

Endpoints

List knowledge bases of a tenant GETCreate a knowledge base POSTDelete a knowledge base DELETERename or describe a knowledge base PUTList documents in a knowledge base GETUpload a document POSTDelete a document DELETEGet processing status of documents POST
Knowledge bases

Delete a knowledge base

Create a knowledge base POST

An empty knowledge base; add documents with POST /v1/tenants/{tenantId}/knowledge-bases/{kbId}/documents and link it to agents.

Rename or describe a knowledge base PUT

Requires knowledge:write

DELETE
/v1/tenants/{tenantId}/knowledge-bases/{id}

Deletes the knowledge base and all its documents. Agents linked to it lose access.

Required permission: knowledge:write

Authorization

Bearer
headerAuthorizationBearer <token>

Tenant API key (evk_…), created in Studio → Vault → API keys.

Path Parameters

tenantId*string

Tenant id, or current for the key's own tenant. Must be the key's tenant or one of its sub-tenants.

id*string

Knowledge base id.

Response Body

Deleted.

Example Request
curl -X DELETE 'https://api.envocal.ai/v1/tenants/string/knowledge-bases/string'
Example Response
Empty
Example Request
curl -X DELETE 'https://api.envocal.ai/v1/tenants/string/knowledge-bases/string'