Conversations bulk actions
Apply the same change to many conversations in one request. The Conversations app uses POST/conversations-bulk-actions with a JSON body for bulk assign owner, change status, assign AI assistant, and move pipeline/stage (including “select all in current view” by resolving ids with repeated find calls of $limit 50).
Endpoint
POST/conversations-bulk-actions
Assign human owner (action: assign)
Unassign human owner:
Change status (action: update_status)
Assign AI assistant (action: assign_ai_assistant)
Unassign AI:
Move pipeline and stage (action: move)
Targeting: conversation_ids, view_id, or filter
Exactly one targeting mode should be used (same logic as the app):
| Field | Description |
|---|---|
conversation_ids | Array of numeric conversation ids. |
view_id | Numeric saved view id (when applying bulk action to “current view” without explicit ids). |
filter | Object narrowing by organization_id, optional pipeline_id, pipeline_stage_id, status (open / closed), and channel. |
Example with filter instead of ids:
Response
json
The app reads processed_count to show how many conversations were updated.
Report an issue with this documentation
Please log in to report issues with our documentation.