# Teler Voice API

**Canonical:** https://apis.io/apis/frejun-teler/teler-voice-api/  
**Provider:** FreJun Teler — https://apis.io/providers/frejun-teler/  
**Base URL:** https://api.frejun.ai  
**Documentation:** https://frejun.com/docs/teler/

Teler Voice API is published by [FreJun Teler](https://apis.io/providers/frejun-teler/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include programmable voice API, voice AI infrastructure, CPaaS, SIP Trunking, and telephony API. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Programmable voice/telephony API. Places and controls live voice calls (initiate, play audio, DTMF, transfer, hangup), streams bidirectional call audio to AI agents over a WebSocket media channel, and provisions programmable SIP trunking (trunks, IP ACLs, virtual numbers). REST resources for calls, voice apps, virtual numbers, SIP trunks/calls, webhook events, recordings and secrets use cursor pagination. Served from https://api.frejun.ai and authenticated with an x-api-key header. Backed by official Python (teler) and Node (@frejun/teler) SDKs.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/calls/initiate` | (Deprecated) Initiate a call |
| POST | `/api/v1/voice/calls/initiate` | Initiate a call |
| GET | `/api/v1/voice/calls` | List calls |
| GET | `/api/v1/voice/calls/{call_id}` | Retrieve a call |
| GET | `/api/v1/voice/calls/{call_id}/legs` | List call legs |
| POST | `/api/v1/voice/apps` | Create a voice app |
| GET | `/api/v1/voice/apps` | List voice apps |
| GET | `/api/v1/voice/apps/{voice_app_id}` | Retrieve a voice app |
| PATCH | `/api/v1/voice/apps/{voice_app_id}` | Update a voice app |
| DELETE | `/api/v1/voice/apps/{voice_app_id}` | Delete a voice app |
| GET | `/api/v1/voice/apps/{voice_app_id}/virtual-numbers` | List virtual numbers for a voice app |
| POST | `/api/v1/voice/calls/{call_id}/hangup` | Hang up a call |
| POST | `/api/v1/voice/calls/{call_id}/mute` | Mute or unmute a call leg |
| POST | `/api/v1/voice/calls/{call_id}/dtmf` | Send DTMF tones on a call leg |
| POST | `/api/v1/voice/calls/{call_id}/play` | Play an audio file into the call |
| POST | `/api/v1/voice/calls/{call_id}/transfer` | Transfer a call |
| GET | `/api/v1/virtual-numbers` | List virtual numbers |
| POST | `/api/v1/virtual-numbers/assign` | Assign virtual numbers |
| POST | `/api/v1/virtual-numbers/unassign` | Unassign virtual numbers |
| PATCH | `/api/v1/virtual-numbers/{vn_id}` | Update a virtual number |
| GET | `/api/v1/sip/calls` | List SIP calls |
| GET | `/api/v1/sip/calls/{call_id}` | Retrieve a SIP call |
| POST | `/api/v1/sip/trunks` | Create a SIP trunk |
| GET | `/api/v1/sip/trunks` | List SIP trunks |
| GET | `/api/v1/sip/trunks/{trunk_id}` | Retrieve a SIP trunk |
| PATCH | `/api/v1/sip/trunks/{trunk_id}` | Update a SIP trunk |
| DELETE | `/api/v1/sip/trunks/{trunk_id}` | Delete a SIP trunk |
| GET | `/api/v1/sip/trunks/{trunk_id}/virtual-numbers` | List virtual numbers for a SIP trunk |
| POST | `/api/v1/sip/ip-acls` | Create an IP access control list |
| GET | `/api/v1/sip/ip-acls` | List IP access control lists |
| GET | `/api/v1/sip/ip-acls/{ip_acl_id}` | Retrieve an IP access control list |
| PATCH | `/api/v1/sip/ip-acls/{ip_acl_id}` | Update an IP access control list |
| DELETE | `/api/v1/sip/ip-acls/{ip_acl_id}` | Delete an IP access control list |
| GET | `/api/v1/events` | List webhook events |
| GET | `/api/v1/events/{event_id}` | Retrieve a webhook event |
| POST | `/api/v1/events/{event_id}/redeliver` | Redeliver a webhook event |
| GET | `/api/v1/recordings` | Get a recording download URL |
| POST | `/api/v1/secrets` | Create a secret |
| GET | `/api/v1/secrets` | List secrets |
| GET | `/api/v1/secrets/{secret_id}` | Retrieve a secret |
| PATCH | `/api/v1/secrets/{secret_id}` | Update a secret |
| DELETE | `/api/v1/secrets/{secret_id}` | Delete a secret |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/openapi/frejun-teler-openapi.json
- **Documentation** — https://frejun.com/docs/teler/
- **APIReference** — https://api.frejun.ai/redoc
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/authentication/frejun-teler-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/conventions/frejun-teler-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/errors/frejun-teler-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/data-model/frejun-teler-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/asyncapi/frejun-teler-webhooks.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/overlays/frejun-teler-openapi-overlay.yaml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/frejun-teler/refs/heads/main/apis.yml

## Tags

programmable voice API, voice AI infrastructure, CPaaS, SIP Trunking, telephony API, real-time media streaming, WebSocket audio, Call Automation, conversational AI infrastructure

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/frejun-teler/teler-voice-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/frejun-teler/.