Browse docs
Getting Started
Introduction
Welcome to the Convoi AI Public API, what it is, how it's organized, and where to start.
3 min read
What you can build
The Convoi AI Public API lets you create and manage real-time voice calls from your own backend. You can launch web calls that connect a browser participant to a Convoi agent over LiveKit, place outbound phone calls to E.164 numbers, and read structured records of every call your account has placed.
The API is REST over HTTPS, returns JSON, and is versioned under /api/v1/public. All requests require a bearer token issued from your dashboard.
Base URL
http
https://go.convoi.ai/backend/api/v1/publicEvery endpoint in this reference is relative to that base URL.
Conventions
- All timestamps are ISO 8601 strings in UTC (e.g. 2026-05-06T12:34:56Z).
- Resource identifiers use a typed prefix: call_…, agt_… (agents), phn_… (phone numbers).
- All requests must include Content-Type: application/json on POST/PUT/PATCH.
- Errors follow RFC 7807 Problem Details. See the Reference section for the schema.
Related in Getting Started