DocumentationAPI ReferenceChangelog

Envocal API

API Reference Tools guide MCP server API Changelog

Endpoints

List tools GETCreate a tool POSTGet a tool GETDelete a tool DELETEUpdate a tool PUTTest a tool POSTList tool templates GETCreate a tool from a template POST
Tools

Delete a tool

Get a tool GET

One tool with everything it is made of: the request, its variables, and the ids of the credential and secrets it uses.

Update a tool PUT

Replaces the tool: read it, change what you need and send all of it back, with the revision you read. A field you leave out gets its default, as when creating: no credential, for example. In config, a variable that keeps its name is the same variable as before, and one with a new name is a new variable. Fields you can't set (id, kind, the timestamps) are ignored if you send them.

DELETE
/v1/tenants/{tenantId}/tools/{id}

Not possible while an agent uses the tool: take it out of the agents' tool assignments first.

Required permission: tools: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

Tool id.

Formatuuid

Response Body

Deleted.

Example Request
curl -X DELETE 'https://api.envocal.ai/v1/tenants/string/tools/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
Empty
DELETE
/v1/tenants/{tenantId}/tools/{id}
Example Request
curl -X DELETE 'https://api.envocal.ai/v1/tenants/string/tools/497f6eca-6276-4993-bfeb-53cbbbba6f08'