Skip to content
VaniAgent DOCS

Web widget

GET /api/developer/v1/widget/config X-API-Key
Read widget configuration
PUT /api/developer/v1/widget/config X-API-Key
Update origins and limits
POST /api/developer/v1/widget/session X-API-Key
Create a short-lived session
GET /api/developer/v1/widget/embed-snippet X-API-Key
Get the embed snippet

Widget configuration includes allowed origins, session duration from 1–60 minutes (default 5), and an optional daily maximum. Session creation accepts agent_id, origin, and optional force_audio.

Never put the Developer API key in the browser. Your server creates the widget session, then returns only the short-lived session data to the page. Match allowed origins exactly and include production HTTPS origins before release.