POST

/conversations/{conversationId}/handoff

Hand the conversation to the AI agent, optionally with a private instruction it must follow.

Authorization

bearer conversations:write

headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: conversations:write

Path Parameters

conversationId*string

Conversation id with channel prefix, e.g. chat_k57… or email_j97….

Match^(chat|email)_[a-z0-9]+$

application/json

instruction?string

Private instruction for the AI (never shown to the customer), e.g. 'Offer a 10% voucher, max once.'

Lengthlength <= 4000

Success

application/json

conversationId*string

aiReplyScheduled*boolean

curl -X POST "https://example.com/conversations/string/handoff" \  -H "Content-Type: application/json" \  -d '{}'

{  "conversationId": "string",  "aiReplyScheduled": true}