Référence de l'API
Référence de l'API
Tous les endpoints de l'API Voiceland AI : authentification, adresse de base, version de l'API et exemples curl pour chaque groupe.
Les descriptions des endpoints et des champs restent en anglais, telles que l'API les publie. C'est un choix délibéré : vous lisez ici ce que vous verrez aussi dans les réponses.
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.
Authentification#
Chaque requête envoie votre clé API dans l'en-tête Authorization, au format Bearer. Les clés se créent dans la section Developers de la console. Ouvrir la console
Authorization: Bearer VL_API_KEY
Adresse de base#
Les requêtes sont envoyées à :
https://api.voiceland.ai/v1
Version de l'API#
Vous pouvez figer la version datée de l'API en envoyant l'en-tête :
Voiceland-Version: 2026-04-26
Groupes d'endpoints#
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 et d'autres.
Agents
11 endpoints : List agents, Create or update an agent, Generate an agent from a brief et d'autres.
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 et d'autres.
Calls
15 endpoints : List calls, Place an outbound call, Get a call et d'autres.
Chat takeover
11 endpoints : List representative availability, Set a representative's availability, List chat takeover sessions et d'autres.
Contacts
9 endpoints : List or look up contacts, Create a contact, Recent journalled calls et d'autres.
Data sources
8 endpoints : List connectors, List data sources, Create a data source et d'autres.
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 et d'autres.
Feedback
8 endpoints : List answer feedback, Rate an answer, Answer satisfaction analytics et d'autres.
Integrations
34 endpoints : Supported integrations as seen from an agent, Remove an integration, Enable or configure an integration et d'autres.
Intents
5 endpoints : List intent candidates, Promote an intent candidate, Dismiss an intent candidate et d'autres.
Knowledge base
39 endpoints : List collections, Create a collection, Delete a collection et d'autres.
Numbers
5 endpoints : Claim a number, List available numbers, Register an external number et d'autres.
Omnichannel
13 endpoints : List channel kinds, List channels, Delete a channel et d'autres.
Operations agents
33 endpoints : List operations agents, Create an operations agent, Design a board with AI et d'autres.
Self-service
31 endpoints : Per-agent call stats, List AI operations reports, AI operations report settings et d'autres.
Web widget
3 endpoints : List test links, Create a test link, Revoke a test link.