Riferimento API
Riferimento API
Tutti gli endpoint dell'API Voiceland AI: autenticazione, indirizzo di base, versione dell'API ed esempi curl per ogni gruppo.
Le descrizioni degli endpoint e dei campi restano in inglese, esattamente come le pubblica l'API. È una scelta voluta: qui legge ciò che vedrà anche nelle risposte.
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.
Autenticazione#
Ogni richiesta invia la sua chiave API nell'intestazione Authorization, in forma Bearer. Le chiavi si creano nella sezione Developers della console. Apri la console
Authorization: Bearer VL_API_KEYIndirizzo di base#
Le richieste vanno a:
https://api.voiceland.ai/v1Versione dell'API#
Se vuole, fissi la versione datata dell'API inviando l'intestazione:
Voiceland-Version: 2026-04-26Gruppi di endpoint#
AI utilities
2 endpoint: Ask a question over a transcript, Transcribe audio.
Account
3 endpoint: Mint a local session, Get your tenant profile, List voices.
Agent assist
2 endpoint: Draft a reply for any conversation, Draft a reply for a live session.
Agent testing
7 endpoint: List test runs, Run a test scenario (synchronous), Get a test run e altri.
Agents
11 endpoint: List agents, Create or update an agent, Generate an agent from a brief e altri.
Audit
2 endpoint: List audit events, Get an audit event.
Calendar
17 endpoint: List bookings (by member window or by phone), Book an appointment, Get a booking e altri.
Calls
15 endpoint: List calls, Place an outbound call, Get a call e altri.
Chat takeover
11 endpoint: List representative availability, Set a representative's availability, List chat takeover sessions e altri.
Contacts
9 endpoint: List or look up contacts, Create a contact, Recent journalled calls e altri.
Data sources
8 endpoint: List connectors, List data sources, Create a data source e altri.
Demo tools
3 endpoint: Demo: a customer's bookings, Demo: look up an order, Demo: current weather for a city.
Evaluation
11 endpoint: List eval runs, Run the agent's golden set (pre-deploy eval), Get an eval run e altri.
Feedback
8 endpoint: List answer feedback, Rate an answer, Answer satisfaction analytics e altri.
Integrations
34 endpoint: Supported integrations as seen from an agent, Remove an integration, Enable or configure an integration e altri.
Intents
5 endpoint: List intent candidates, Promote an intent candidate, Dismiss an intent candidate e altri.
Knowledge base
39 endpoint: List collections, Create a collection, Delete a collection e altri.
Numbers
5 endpoint: Claim a number, List available numbers, Register an external number e altri.
Omnichannel
13 endpoint: List channel kinds, List channels, Delete a channel e altri.
Operations agents
33 endpoint: List operations agents, Create an operations agent, Design a board with AI e altri.
Self-service
31 endpoint: Per-agent call stats, List AI operations reports, AI operations report settings e altri.
Web widget
3 endpoint: List test links, Create a test link, Revoke a test link.