DocumentationAPI ReferenceChangelog

Envocal API

API Reference API Changelog

Endpoints

List phone numbers of a tenant GETAdd a phone number POSTGet a phone number GETDelete a phone number DELETEChange a phone number PUT
Phone numbers

Change a phone number

Delete a phone number DELETE

Requires phone_numbers:write

Get a conversation GET

Who talked to which agent and when, the transcript, the summary and how it ended.

PUT
/v1/tenants/{tenantId}/phone-numbers/{id}

Changes the number itself; its tenant and agent assignment stay the same.

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

Phone number id.

Request Body

The new number.

  1. body
  1. body
  2. …

A changed phone number.

number*string

The new number in E.164 format.

Response Body

Updated.

Example Request
curl -X PUT 'https://api.envocal.ai/v1/tenants/string/phone-numbers/string' \  -H 'Content-Type: application/json' \  -d '{  "number": "string"}'
Example Response
Empty
Example Request
curl -X PUT 'https://api.envocal.ai/v1/tenants/string/phone-numbers/string' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": "string"
}'