Take over conversation | Runtype Documentation

Switch a messaging conversation into human-operator mode so inbound messages are persisted but agent replies are suppressed.

AuthorizationBearer

API key or Clerk session token

idstringRequired

This endpoint expects an object.

reasonstringOptional<=1000 characters

Conversation switched to human mode

agentModestring

idstring

takeoverActorIdstring or null

takeoverActorTypestring or null

takeoverAtstring or null

takeoverReasonstring or null

updatedAtstring

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/messaging/conversations/id/takeover \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"agentMode": "human-operator",
3	"id": "conv_1234567890abcdef",
4	"takeoverActorId": "agent_9876543210fedcba",
5	"takeoverActorType": "support-agent",
6	"takeoverAt": "2024-06-15T10:45:00Z",
7	"takeoverReason": "Customer requested to speak with a human agent due to complex issue.",
8	"updatedAt": "2024-06-15T10:45:05Z"
9	}