RinghouseAPI reference
Get started

Conversations

Set conversation status

Move a thread between folders — the same move the inbox makes when somebody marks it done.

POST/v1/conversations/{conversation_id}/status

Needs the conversations:write scope.

Path parameters

conversation_idstringrequired
Conversation id

Body parameters

statusstringrequired
The folder slug to move it to: `open` or `done`.

Returns

The moved conversation. A failed call answers with an error instead.

idstring
contactstring
The other end of the thread, in E.164.
createdAtstring
lastItemAtstring
lastItemKindstringnullable
What the most recent activity was: sms_message, call_log, comment, reaction, assignment.
numberIdstring
statusstring
The folder it sits in — `open` or `done` for the two every workspace has.
curl -X POST https://api.ringhouse.ai/v1/conversations/{conversation_id}/status \
  -H "Authorization: Bearer rh_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "<string>"
  }'
{
  "id": "8c1d4e7a-5b2f-4a90-9e1c-3f7d2b6a1c08",
  "contact": "…",
  "createdAt": "2026-09-25T14:02:11Z",
  "lastItemAt": "2026-09-25T14:02:11Z",
  "lastItemKind": "…",
  "numberId": "e41b09c2-77d3-4c5e-b0a8-9d2f61c4e3a7",
  "status": "completed"
}
Was this page helpful?
Previous← Get a conversationNextList contacts