Update a conversation
Authorizations
Path Parameters
ID of the conversation to update.
Body
New status for the conversation (requires conversation.status permission).
OPENED, CLOSED, SPAM, SNOOZED When status is SNOOZED, specifies when to unsnooze. Formats:
- "5m", "+30" (minutes from now)
- "tomorrow", "monday", "tuesday", etc. (next occurrence at 9am)
- "one week", "one month" (relative periods)
- ISO 8601 timestamp (absolute time)
ID of agent to assign. Use null to unassign (requires conversation.assign permission).
Email of agent to assign (alternative to agent_id, requires conversation.assign permission).
New subject line for the conversation (requires conversation.update permission).
80ID of an existing recipient to set as the primary contact.
Response
Conversation updated successfully.
Unique identifier for the conversation
12345
ID of the primary contact who initiated the conversation
789
Subject line of the conversation, derived from the first message or manually set
250"Question about billing"
Current status of the conversation
OPENED, CLOSED, SPAM, SNOOZED "OPENED"
ISO 8601 timestamp of the last incoming message in the conversation
"2026-01-21T14:30:00Z"
Array of tag IDs associated with this conversation
[1, 5, 12]Array of recipients in the conversation (to, cc, bcc)
ID of the agent assigned to this conversation, or null if unassigned
42
ID of the channel through which this conversation is conducted
1
ISO 8601 timestamp indicating when a snoozed conversation should reappear, or null if not snoozed
"2026-01-22T09:00:00Z"
Pagination cursor for retrieving the next page of conversations in a list
"cur_1234567890"