Skip to content
LogoLogo

Create a private GPT Live WebRTC session

Create a private GPT Live WebRTC session

POST/api/v1/workspaces/{workspace_id}/discuss/voice/sessions

Exchanges a browser WebRTC offer for a server-configured GPT Live answer. The OpenAI API key remains on the private Knowledge service. Assign selects the model, disables provider storage, supplies bounded private Discuss history, and configures client delegation back into canonical Discuss. The client must wait for session.started before treating voice as ready.

Path Parameters

workspace_idRequired
string <uuid>
Example0198ac5e-f9b7-7000-8000-000000000001

Header Parameters

X-CSRF-TokenRequired
string·min 43·max 43

Session-bound CSRF token. It must exactly match the __Host-assign_csrf cookie sent with the request.

Request Body

application/json
sdpRequired
string·min 1·max 65536

Browser WebRTC SDP offer after ICE gathering completes.

locale
string·min 2·max 35

Optional BCP 47 locale hint.

spoken_response_mode
string·default full

Account playback policy for generated voice output.

Values
offconfirmationsfull
confirmation_level
string·default standard

Account safety preference for how readily Voice asks before actions.

Values
standardconfirm_more

Responses