Bulk update multiple conversations
Bulk update multiple conversations
POST
Bulk update multiple conversations
Updates multiple conversations in a single request. Supports changing status, assigning agents, and managing tags. Status changes to SPAM can optionally block the contact. Changes are applied atomically per conversation, and only successful updates are returned.
Authorizations
Body
application/json
Array of conversation IDs to update.
New status for the conversations. DELETE will permanently delete them.
Available options:
OPENED, CLOSED, SPAM, SNOOZED, DELETE 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.
Email of agent to assign (alternative to agent_id).
Tag name to add to the conversations.
Maximum string length:
50Tag name to remove from the conversations.
When marking as SPAM, whether to also block the contact (requires contact.block permission).
Response
Conversations updated successfully.
Array of successfully updated conversations.