Set conversation status
Set a conversation to Active, Pending, Closed or Spam.
PUT https://cotlet.dev/api/v1/freescout/conversations/{conversation_id}/status
write
Changes the status of one conversation, the same as the Status dropdown. It sends nothing to the customer and one more call sets it back, so it does not wait for your OK. FreeScout has only these four statuses. If your team has a Workflows rule that emails the customer on closing, that rule still runs.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation ID from list_conversations or get_conversation. It is not the #number shown in the list. |
| status string required | string | active, pending, closed or spam. |
Request
curl -X PUT https://cotlet.dev/api/v1/freescout/conversations/4790/status \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"closed"}'result = client.call("freescout", "set_conversation_status", {"conversation_id":4790,"status":"closed"})const result = await cotlet.call('freescout', 'set_conversation_status', {"conversation_id":4790,"status":"closed"});cotlet call freescout set_conversation_status --data '{"conversation_id":4790,"status":"closed"}'Example response
{
"conversation_id": 4790,
"status": "closed",
"changed_at": "2026-10-23T08:20:00Z"
}