API reference
API reference
Every endpoint of the Voiceland AI API: authentication, the base URL, the API version, and curl examples for every group.
REST API for building and operating voice agents. Authenticate every request with your API key: Authorization: Bearer vsk_…. Optionally pin the dated API version with the Voiceland-Version header.
Authentication#
Every request sends your API key in the Authorization header, in Bearer form. Keys are minted in the Developers section of the console. Open the console
Authorization: Bearer VL_API_KEYBase URL#
Requests go to:
https://api.voiceland.ai/v1API version#
Optionally pin the dated API version by sending the header:
Voiceland-Version: 2026-04-26Endpoint groups#
AI utilities
2 endpoints: Ask a question over a transcript, Transcribe audio.
Account
3 endpoints: Mint a local session, Get your tenant profile, List voices.
Agent assist
2 endpoints: Draft a reply for any conversation, Draft a reply for a live session.
Agent testing
7 endpoints: List test runs, Run a test scenario (synchronous), Get a test run and more.
Agents
11 endpoints: List agents, Create or update an agent, Generate an agent from a brief and more.
Audit
2 endpoints: List audit events, Get an audit event.
Calendar
17 endpoints: List bookings (by member window or by phone), Book an appointment, Get a booking and more.
Calls
15 endpoints: List calls, Place an outbound call, Get a call and more.
Chat takeover
11 endpoints: List representative availability, Set a representative's availability, List chat takeover sessions and more.
Contacts
9 endpoints: List or look up contacts, Create a contact, Recent journalled calls and more.
Data sources
8 endpoints: List connectors, List data sources, Create a data source and more.
Demo tools
3 endpoints: Demo: a customer's bookings, Demo: look up an order, Demo: current weather for a city.
Evaluation
11 endpoints: List eval runs, Run the agent's golden set (pre-deploy eval), Get an eval run and more.
Feedback
8 endpoints: List answer feedback, Rate an answer, Answer satisfaction analytics and more.
Integrations
34 endpoints: Supported integrations as seen from an agent, Remove an integration, Enable or configure an integration and more.
Intents
5 endpoints: List intent candidates, Promote an intent candidate, Dismiss an intent candidate and more.
Knowledge base
39 endpoints: List collections, Create a collection, Delete a collection and more.
Numbers
5 endpoints: Claim a number, List available numbers, Register an external number and more.
Omnichannel
13 endpoints: List channel kinds, List channels, Delete a channel and more.
Operations agents
33 endpoints: List operations agents, Create an operations agent, Design a board with AI and more.
Self-service
31 endpoints: Per-agent call stats, List AI operations reports, AI operations report settings and more.
Web widget
3 endpoints: List test links, Create a test link, Revoke a test link.