Take a conversation over from the AI bot
POST/api/conversations/:conversationId/handover/take
Manual human takeover: assigns the conversation to the acting agent and
silences the AI bot for it (ai_active becomes false, clearing any
pending-handover marker). Any staff member may take a conversation onto
THEMSELVES (the takeOver capability) — it does not require the assign
(supervisor) capability, but it can only ever assign the conversation to
the caller. The change is delivered live over the realtime
conversation.updated event.
The optional body chooses HOW LONG the AI stays silenced:
resume_after_minutes (null / omitted = indefinite — manual release only;
a positive integer auto-resumes the bot after that many minutes) and
reply_on_resume (whether, on that automatic resume, the bot replies to
the conversation's last unanswered message — defaults to true).
Request
Responses
- 200
- 401
- 403
- 404
The conversation after takeover.
Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).
Authenticated but not allowed.
Resource not found (or not visible to the current tenant).