Skip to main content
POST
Take Over Session
Marks the session as human-driven so the widget stops generating AI replies. Idempotent — repeated calls just refresh the takeover timestamp. Hand control back with Release.

Authentication

Requires a Bearer token (API key) or a dashboard session.

Path Parameters

id
string
required
The widget config UUID.
sessionId
string
required
The session UUID.

Response

session_id
string
takeover_status
string
"human" after a successful takeover.
taken_over_by
string
The operator user ID.
taken_over_at
string
ISO timestamp of the takeover.

Example

curl