Set conversation status

Open, pend, resolve or snooze a conversation.

PUT https://cotlet.dev/api/v1/chatwoot/conversations/{conversation_id}/status

write

Sets the status to open, pending, resolved or snoozed. A snooze without snoozed_until lasts until the customer writes again, and a reply from the customer always reopens a snoozed conversation. Automation rules on Conversation updated or Conversation opened run as they do for a person. set_conversation_status runs without asking first: it sends nothing to the customer and is undone with one call.

Parameters

Parameters: set_conversation_status
NameTypeDescription
conversation_id integer required integer conversation_id from list_conversations. It is the number in the conversation URL.
status string required string open, pending, resolved or snoozed.
snoozed_until string string ISO 8601 time to reopen, only with status snoozed.

Request

cURL
curl -X PUT https://cotlet.dev/api/v1/chatwoot/conversations/1790/status \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"snoozed","snoozed_until":"2026-11-02T09:00:00Z"}'
Python
result = client.call("chatwoot", "set_conversation_status", {"conversation_id":1790,"status":"snoozed","snoozed_until":"2026-11-02T09:00:00Z"})
Node.js
const result = await cotlet.call('chatwoot', 'set_conversation_status', {"conversation_id":1790,"status":"snoozed","snoozed_until":"2026-11-02T09:00:00Z"});
CLI
cotlet call chatwoot set_conversation_status --data '{"conversation_id":1790,"status":"snoozed","snoozed_until":"2026-11-02T09:00:00Z"}'

Example response

JSON

{
  "conversation_id": 1790,
  "status": "snoozed",
  "snoozed_until": "2026-11-02T09:00:00Z"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.