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 voices

Get a model GET

Requires agents:read

Get a voice GET

Requires agents:read

GET
/v1/tenants/{tenantId}/voices

The voices the tenant's agents can speak with, in display order. An agent's voice is one of these keys, and it must work with the agent's model: pass model to get exactly the voices an agent on that model can use. Each voice has a short sample clip (sampleUrl).

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

model?string

Only voices an agent on this model can use, e.g. gpt-realtime-1.5.

provider?string

Only voices from this provider, e.g. openai.

gender?string

Only voices of this gender: female, male or neutral.

age?string

Only voices of this age: young, middle-aged or old.

language?string

Only voices that speak this language (BCP 47, e.g. sv or en-GB): with model, on that model; without, on any of their models. Voices whose primary language it is come first.

Response Body

The voices.

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

A voice an agent can speak with.

Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/voices'
Example Response
[  {    "key": "string",    "name": "string",    "description": "string",    "provider": {      "key": "string",      "name": "string",      "logoUrl": "string"    },    "gender": "female",    "age": "young",    "language": "string",    "region": "string",    "accent": "string",    "multilingual": true,    "languages": [      "string"    ],    "tags": [      "string"    ],    "sampleUrl": "string",    "models": [      "string"    ],    "status": "preview"  }]
GET
/v1/tenants/{tenantId}/voices
Example Request
curl -X GET 'https://api.envocal.ai/v1/tenants/string/voices'
[
  {
    "key": "string",
    "name": "string",
    "description": "string",
    "provider": {
      "key": "string",
      "name": "string",
      "logoUrl": "string"
    },
    "gender": "female",
    "age": "young",
    "language": "string",
    "region": "string",
    "accent": "string",
    "multilingual": true,
    "languages": [
      "string"
    ],
    "tags": [
      "string"
    ],
    "sampleUrl": "string",
    "models": [
      "string"
    ],
    "status": "preview"
  }
]