GenAiHandoff

Releases the assistant's ownership and triggers routing.

Every field of the 200 body can be false and none of them is an error: released: false is "a human got there first", dispatched: false is "this tenant has no live-chat routing queue", alreadyHandled: true is "you already sent this". A caller must not retry on any of them — only a 5xx is a failure on this route.

The one retryable outcome therefore IS a 5xx: 503 with ResultCode.GenAiHandoffRoomUnreadable means the release happened but the room could not be re-read, so routing was never triggered and the replay gate was deliberately withheld. Retry it — the redelivery is the only thing that can finish the transfer.

post/api/chat/rooms/{roomId}/genai-handoff

Request

Path parameters

roomIdinteger required

Query parameters

accountIdinteger
departmentIdinteger

Request body

aiBotIdinteger
reasonstring nullable
idempotencyKeystring nullable
transferMessageIdstring nullable

Response

OK

releasedboolean
dispatchedboolean
alreadyHandledboolean

Changes

No recorded changes to this operation across all 3 revisions of this API.