Create an authenticated LiveKit browser-test session for one hosted agent

Workspace-authenticated only. Does not use the anonymous homepage demo budget. New sessions reserve eligible browser-only welcome credit or purchased funds and settle actual component usage; no carrier charge applies. The existing session limit is 180 seconds. Historical zero-charge snapshots remain unchanged. The selected snapshot is published or a validated draft overlay. A draft overlay naming an unknown, retired, or language-incompatible selection is rejected with a plain 400 before this point, as before. Beyond that, the resolved realtime configuration -- the agent's stack merged with any draft overlay -- is checked for runnability before anything is reserved; a config the voice worker would refuse before building media (missing prompt/first message, missing provider/model/voice, or an unsupported language) is refused here instead of reaching the worker.

post/v1/agents/{agent_id}/browser-sessions

Request

  • Base URL: https://api.skysay.ai
  • URL: https://api.skysay.ai/v1/agents/{agent_id}/browser-sessions
  • Auth: none declared

Path parameters

agent_idstring required

Request body

organization_idstring required
project_idstring required
snapshot'published' | 'draft'
test_valuesobject

Values for the agent's declared variables, for this test call only. Built-ins (contact., call., campaign.*) are not sent. Refused like a call's values: 400 with reason one of call_variables_missing, call_variables_invalid, call_variables_over_budget, workflow_binding_failed, schema_pair_mismatch, per_call_text_on_workflow, agent_not_published, keypad_value_not_dialable, keypad_value_in_text, and field / where naming the variable or line (never a value).

Response

Reservation and dispatch metadata for a LiveKit join token

Changes

No recorded changes to this operation across all 1 revision of this API.