> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.next-dev.rtcleague.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.next-dev.rtcleague.com/_mcp/server.

# Introduction

The **TelEcho Public API** lets you start calls, manage agents, and read call
records programmatically from your own backend.

## What you can do

* **Place outbound calls** through your imported phone numbers.
* **Start web calls** that connect a browser participant to one of your agents over LiveKit.
* **List your agents** and their voice configuration.
* **List your phone numbers** and the agents assigned to them.
* **Read your call records** — duration, cost, recording URL, transcript reference.

## Base URL

```
https://api.telecho.io/api/v1/public
```

All requests are HTTPS, return JSON, and require a bearer API key.

## Conventions

| Topic       | Convention                                                                      |
| ----------- | ------------------------------------------------------------------------------- |
| Auth        | `Authorization: Bearer tel_live_xxx`                                            |
| IDs         | Prefixed strings — `tel_agt_*`, `tel_pn_*`, `tel_call_*`                        |
| Pagination  | Opaque cursors via `cursor` query param + `next_cursor` in response             |
| Errors      | `{ "error": { "type": "...", "code": "...", "message": "..." } }`               |
| Rate limits | `60/min`, `1000/hour` per key (see [Rate limits](/getting-started/rate-limits)) |

> **Tip**
>
> Start with the [Quickstart](/getting-started/quickstart) — make your first call in under 5 minutes.