Skip to navigation

Introduction

Welcome to the TelEcho Public API.

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

TopicConvention
AuthAuthorization: Bearer tel_live_xxx
IDsPrefixed strings — tel_agt_*, tel_pn_*, tel_call_*
PaginationOpaque cursors via cursor query param + next_cursor in response
Errors{ "error": { "type": "...", "code": "...", "message": "..." } }
Rate limits60/min, 1000/hour per key (see Rate limits)

Start with the Quickstart — make your first call in under 5 minutes.