Conversations
Bulk update conversations
POST
Apply one action to many conversations: set workflow, switch AI agent, trash, or move emails to spam/inbox.
bearer conversations:writeheader
AuthorizationBearer <token>API key (rsl_live_…) from Settings → Developers.
Scope: conversations:write
application/json- body
conversationIds*array<>Items
1 <= items <= 100action*stringValue in
"set_workflow""set_agent""trash""move_to_spam""move_to_inbox"workflow?stringFor set_workflow.
Value in
"waiting_human""waiting_review""ai_inactive""ai_in_progress""waiting_external""human_in_progress""waiting_customer""ai_resolved""resolved""closed"agentId?stringFor set_agent.
Length
1 <= length <= 64Success
application/json- response
updated*numberskipped*numbercurl -X POST "https://example.com/conversations/bulk" \ -H "Content-Type: application/json" \ -d '{ "conversationIds": [ "string" ], "action": "set_workflow" }'{ "updated": 0, "skipped": 0}View attachment GET
One attachment of a message or email as base64, up to 4 MB: images in images (MCP returns them as images the assistant can see), other files in files. This is the only way to download chat attachments; no permanent links are returned.
Send new email POST
Start a new email conversation with a customer and send the first email.