Developers · API
v1LiveSpeech API
An API that puts an AI agent on a phone number. From your own service, create an agent for each business you serve, set how it answers, and collect a summary when each call ends.
Two ways to use LiveSpeech. To run a phone number for each business you serve, use this API — REST, server to server. To build your own voice app, go to the SDK docs — TypeScript and Rust packages that handle sessions, tool calling and interruptions in your code.
Quickstart
From your key to a first agent and its call results in ten minutes.
Guides
Agents, agent settings, call results and webhooks, in the order you use them.
API reference
Every endpoint, request and response.
What you can do
| You can | Read |
|---|---|
| Create an agent per business, list and read agents, terminate them | Agents |
| Set an agent's persona, greeting, business hours and summary email recipients | Agent settings |
| Fetch summaries and outcomes after calls end | Call results |
| Receive an event on your server the moment a call ends | Webhooks |
| Request a phone number for an agent and read its status — early access | Phone numbers |
| Not in the API | How to do it |
|---|---|
| Releasing a phone number from an agent | Email support@livespeech.ai with the agent's agentId |
| Rotating or revoking API keys | If a key leaks, email support@livespeech.ai right away |
| Outbound AI calls · changing the answering language | Email support@livespeech.ai with the agent's agentId |
| Recordings and transcripts | Not provided |
An API for storing a business's commerce integration credentials on an agent is available on request.
Requests at a glance
| Method | Path | What it does |
|---|---|---|
GET | /v1/whoami | Check that the key works and which scopes it has |
POST | /v1/agents | Create an agent |
GET | /v1/agents | List agents |
GET | /v1/agents/{agentId} | Read an agent |
DELETE | /v1/agents/{agentId} | Terminate an agent |
GET PUT | /v1/agents/{agentId}/settings | Read and update agent settings |
GET | /v1/agents/{agentId}/calls | List call results |
POST GET | /v1/agents/{agentId}/number | Request a number and read its status — early access |
PUT GET | /v1/webhooks | Register and read the webhook |
The base URL is https://console-api.livespeech.ai. Send every request from your server — the key must never ship in browser code.
Building your own voice app? Go to the SDK docs