Get started
Introduction
Learn about the API architecture, the resource/action pattern, and available resources.
Authentication
Obtain a Bearer token from Supabase Auth and authenticate your requests.
Making requests
Understand request structure, response envelopes, and common patterns.
Error handling
Handle errors with standardized error codes and response formats.
API reference
Agents
Create and manage voice agents (genies), groups, and conversations.
Knowledge
Manage documents and organize them into folders for your agents.
Voice
Browse voices, manage favorites, and organize voice collections.
CRM
Track leads captured by your agents and attach notes.
Marketplace
Browse and manage marketplace agent templates.
Platform
Manage user profiles, teams, and activity logs.
Quick reference
Every resource and its available actions at a glance:| Resource | Actions |
|---|---|
| Genies | list all get create update delete reorder |
| Knowledge Base | list get create update delete sync-with-agents attach detach replace |
| Document Folders | all list get create update delete reorder counts |
| Genie Groups | list get create update delete reorder counts sync |
| Conversations | list get sync analyze update delete |
| Voices | favorites popular recent add-favorite remove-favorite track-usage |
| Voice Collections | all get create update delete |
| Leads | stats all list get create update delete |
| Lead Notes | list get create update delete togglePin pinned |
| Marketplace | list all get create update delete categories stats |
| Profiles | all list get create update delete |
| Teams | get create update delete members invite invitations cancel-invite remove-member |
| Activities | all get create |
All requests are
POST to a single endpoint with the resource and action specified in the request body. See Making requests for full details.