Conversations
Update conversation
PATCH
Star, change the workflow state, switch the AI agent or move an email to spam/inbox.
bearer conversations:writeheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: conversations:write
conversationId*stringConversation id with channel prefix, e.g. chat_k57… or email_j97….
Match
^(chat|email)_[a-z0-9]+$application/json- body
isStarred?booleanworkflow?stringSet the detailed state, e.g. waiting_human to escalate. ai_in_progress may make the AI reply.
Value in
"waiting_human""waiting_review""ai_inactive""ai_in_progress""waiting_external""human_in_progress""waiting_customer""ai_resolved""resolved""closed"agentId?stringAI agent handling the conversation.
Length
1 <= length <= 64mailbox?stringEmail only.
Value in
"inbox""spam"Success
application/json- response
conversationId*stringok*trueValue in
truechanged*array<string>curl -X PATCH "https://example.com/conversations/string" \ -H "Content-Type: application/json" \ -d '{}'{ "conversationId": "string", "ok": true, "changed": [ "string" ]}