DocumentationAPI ReferenceChangelog

Envocal API

API Reference Tools guide MCP server API Changelog

Endpoints

List models GETGet a model GETList voices GETGet a voice GET
Models & voices

List models

Create an agent from a template POST

Copies the template's instructions, variables and voice settings into a new draft agent in the tenant, with a default widget configuration whose settings are all unset (the widget's defaults apply). Phone number, knowledge bases and tools are not copied.

Get a model GET

Requires agents:read

GET
/v1/tenants/{tenantId}/models

The AI models the tenant's agents can use, in display order. An agent's model is one of these keys; a model's reasoningLevels are the values its reasoningLevel can take. Models marked preview can be chosen but may still change.

Required permission: agents:read

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.

Query Parameters

kind?string

Only models of this kind, e.g. speech-to-speech.

Response Body

The models.

  1. response
  1. response
  2. …
[index: integer]?

An AI model an agent can use.

Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/models'
Example Response
[  {    "key": "string",    "name": "string",    "description": "string",    "provider": {      "key": "string",      "name": "string",      "logoUrl": "string"    },    "kind": "speech-to-speech",    "inputModalities": [      "string"    ],    "outputModalities": [      "string"    ],    "languages": [      "string"    ],    "supportsTools": true,    "reasoningLevels": [      "string"    ],    "defaultReasoningLevel": "string",    "isDefault": true,    "defaultVoice": "string",    "status": "preview"  }]
GET
/v1/tenants/{tenantId}/models
Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/models'
[
  {
    "key": "string",
    "name": "string",
    "description": "string",
    "provider": {
      "key": "string",
      "name": "string",
      "logoUrl": "string"
    },
    "kind": "speech-to-speech",
    "inputModalities": [
      "string"
    ],
    "outputModalities": [
      "string"
    ],
    "languages": [
      "string"
    ],
    "supportsTools": true,
    "reasoningLevels": [
      "string"
    ],
    "defaultReasoningLevel": "string",
    "isDefault": true,
    "defaultVoice": "string",
    "status": "preview"
  }
]