Update the status of a conversation

Change a conversation status to one of:

  • opened — re-opens a previously closed or snoozed conversation
  • closed — closes the conversation (runs CSAT/classification flow when enabled)
  • snoozed — snoozes the conversation for snooze_time seconds (requires the snoozing feature)

Request Fields

Required fields

  • status (string): The target status. One of opened, closed, snoozed.

Conditional fields

  • snooze_time (integer): Required only when status is snoozed. Snooze duration in seconds.
    Only open conversations can be snoozed.

Examples

Close a conversation

{ "status": "closed" }

Re-open a conversation

{ "status": "opened" }

Snooze a conversation for one hour

{ "status": "snoozed", "snooze_time": 3600 }
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
\d+

The conversation id

Body Params
string
enum
required

The target conversation status

Allowed:
integer | null

Snooze duration in seconds (required only when status is snoozed)

Responses

401

Authentication required

403

Permission denied or conversation access denied

404

Conversation not found

409

Conversation is frozen

422

Validation failed

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json