Introduction
Public REST API for the Speko voice gateway.
Welcome
The Speko API exposes the voice gateway and agent control plane from https://api.speko.dev. Core endpoints include sessions, sessions/phone, phone-numbers, calls, callbacks, transcribe, synthesize, complete, agents, knowledge-bases, usage, credits, and provider configuration. Calls that carry a routing intent let Speko pick the highest-scoring provider and fail over server-side. Phone calls support inbound routing, outbound PSTN dialing, lifecycle webhooks, post-call reports, recordings, and blind or warm transfers. The full spec is below.
OpenAPI specification
View the OpenAPI 3.1 spec file
Servers
| Environment | Base URL |
|---|---|
| Production | https://api.speko.dev |
Authentication
All endpoints are authenticated with a bearer API key. Mint one at API keys.
Authorization: Bearer sk_live_...The OpenAPI spec declares this scheme as bearerAuth:
"security": [
{
"bearerAuth": []
}
]Tool calling
Give a Speko voice agent the ability to invoke webhook tools mid-call. Register once in the dashboard, fire from any voice session.
Sessions
Mints browser-safe media transport credentials, persists the pipeline config, and dispatches an agent worker. Use the returned `transportToken` and `transportUrl` with `@spekoai/client` to join from a browser.