DocumentationAPI ReferenceChangelog

Envocal API

API Reference API Changelog

Endpoints

List agents of a tenant GETCreate an agent POSTGet an agent GETDelete an agent DELETEUpdate an agent PUTAssign a phone number to an agent POSTUnassign an agent's phone number DELETEList an agent's knowledge bases GETLink a knowledge base to an agent POSTUnlink a knowledge base from an agent DELETEList agent templates GETCreate an agent from a template POST
Agents

Unlink a knowledge base from an agent

Link a knowledge base to an agent POST

The agent can then search the knowledge base during conversations. The knowledge base must belong to the agent's tenant.

List agent templates GET

Templates (agents with isTemplate true) that the tenant can use: its own and those of its parent tenants.

DELETE
/v1/tenants/{tenantId}/agents/{agentId}/knowledge-bases/{kbId}

The knowledge base itself is not deleted.

Required permission: agents: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.

agentId*string

Agent id.

kbId*string

Knowledge base id.

Response Body

Unlinked.

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