API-Referenz
API-Referenz
Alle Endpoints der Voiceland AI API: Authentifizierung, Basisadresse, API-Version und curl-Beispiele für jede Gruppe.
Die Beschreibungen der Endpoints und der Felder erscheinen auf Englisch, genau so, wie die API sie ausliefert. Das ist Absicht: Sie lesen hier, was Sie auch in den Antworten sehen.
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.
Authentifizierung#
Jede Anfrage sendet Ihren API-Schlüssel im Authorization-Header, in der Bearer-Form. Schlüssel erstellen Sie im Bereich Developers der Konsole. Konsole öffnen
Authorization: Bearer VL_API_KEYBasisadresse#
Anfragen gehen an:
https://api.voiceland.ai/v1API-Version#
Optional binden Sie die datierte API-Version, indem Sie diesen Header senden:
Voiceland-Version: 2026-04-26Endpoint-Gruppen#
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 und weitere.
Agents
11 Endpoints: List agents, Create or update an agent, Generate an agent from a brief und weitere.
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 und weitere.
Calls
15 Endpoints: List calls, Place an outbound call, Get a call und weitere.
Chat takeover
11 Endpoints: List representative availability, Set a representative's availability, List chat takeover sessions und weitere.
Contacts
9 Endpoints: List or look up contacts, Create a contact, Recent journalled calls und weitere.
Data sources
8 Endpoints: List connectors, List data sources, Create a data source und weitere.
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 und weitere.
Feedback
8 Endpoints: List answer feedback, Rate an answer, Answer satisfaction analytics und weitere.
Integrations
34 Endpoints: Supported integrations as seen from an agent, Remove an integration, Enable or configure an integration und weitere.
Intents
5 Endpoints: List intent candidates, Promote an intent candidate, Dismiss an intent candidate und weitere.
Knowledge base
39 Endpoints: List collections, Create a collection, Delete a collection und weitere.
Numbers
5 Endpoints: Claim a number, List available numbers, Register an external number und weitere.
Omnichannel
13 Endpoints: List channel kinds, List channels, Delete a channel und weitere.
Operations agents
33 Endpoints: List operations agents, Create an operations agent, Design a board with AI und weitere.
Self-service
31 Endpoints: Per-agent call stats, List AI operations reports, AI operations report settings und weitere.
Web widget
3 Endpoints: List test links, Create a test link, Revoke a test link.