Take over conversation | Runtype Documentation

Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed. The claim is atomic: when two operators take over at once, exactly one succeeds and the other receives 409 carrying the winner’s takeoverActorId. A takeover lapses and the agent resumes after the surface’s interventionMode.takeoverIdleTimeoutMinutes (default 24h) with no operator send; closing or reopening the conversation also clears it.

Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed. The claim is atomic: when two operators take over at once, exactly one succeeds and the other receives 409 carrying the winner's takeoverActorId. A takeover lapses and the agent resumes after the surface's interventionMode.takeoverIdleTimeoutMinutes (default 24h) with no operator send; closing or reopening the conversation also clears it.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Request

This endpoint expects an object.

reasonstringOptional<=1000 characters

Response

Conversation switched to human mode

agentModestring

idstring

takeoverActorIdstring or null

takeoverActorTypestring or null

takeoverAtstring or null

takeoverReasonstring or null

updatedAtstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error