Skip to main content
POST
/
api
/
v1
/
accounts
/
{account_id}
/
conversations
/
{conversation_id}
/
toggle_status
Toggle Status
curl --request POST \
  --url https://app.chatwoot.com/api/v1/accounts/{account_id}/conversations/{conversation_id}/toggle_status \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "status": "open",
  "snoozed_until": 1757506877
}
'
{
  "meta": {},
  "payload": {
    "success": true,
    "current_status": "open",
    "conversation_id": 123
  }
}

Authorizations

​
api_access_token
string
header
required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

​
account_id
integer
required

The numeric ID of the account

​
conversation_id
integer
required

The numeric ID of the conversation

Body

application/json
​
status
enum<string>
required

The status of the conversation

Available options:
open,
resolved,
pending,
snoozed
Example:

"open"

​
snoozed_until
number

When status is snoozed, schedule the reopen time as a Unix timestamp in seconds. If not provided, the conversation is snoozed until the next customer reply. The conversation always reopens when the customer replies.

Example:

1757506877

Response

Success

​
meta
object
​
payload
object