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.

La console

Ces pages sont en lecture seule. L'appel de test, les clés API et la référence de l'API à jour se trouvent dans la console, où votre compte est connecté.

Ouvrir la console