Batch Bulk Inbox Actions

Executes atomic batch actions across multiple conversations simultaneously, including resolving, reopening, reassigning, snoozing, and tagging/untagging.

POST/api/v1/inbox/bulk

Request Body Schema

application/json

conversation_idsuuid[]required

Array of conversation UUIDs (1-100 items)

actionstringrequired

Bulk action: resolve, reopen, assign, snooze, tag, untag

Example:resolve

payload.assigned_touuid|nulloptional

Target agent user UUID (required for assign)

payload.duration_hoursnumberoptional

Hours to snooze from now (1 to 720)

payload.snoozed_untildatetimeoptional

Specific future timestamp (ISO 8601 in IST, min 5 minutes)

payload.tag_iduuidoptional

Tag UUID to apply or remove (required for tag/untag)

Response Payload

200 OKapplication/json

successbooleanrequired

Whether bulk action succeeded

data.actionstringrequired

Action executed

data.affected_countnumberrequired

Number of conversations modified

data.updated_atdatetimerequired

Execution timestamp in IST (+05:30)

Code Snippets & Examples

1	curl -X POST "https://app.chatofy.in/api/v1/inbox/bulk" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"conversation_ids":["conv-8888-9999-aaaa-bbbbccccdddd","conv-1111-2222-3333-444455556666"],"action":"resolve"}'

Was this endpoint guide helpful?

Previous Endpoint

Reopen Snoozed Conversation

Next Endpoint

Get Conversation Media Gallery

1	curl -X POST "https://app.chatofy.in/api/v1/inbox/bulk" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"conversation_ids":["conv-8888-9999-aaaa-bbbbccccdddd","conv-1111-2222-3333-444455556666"],"action":"resolve"}'

200 OKapplication/json

1	{
2	"success": true,
3	"data": {
4	"action": "resolve",
5	"affected_count": 2,
6	"updated_at": "2026-10-27T10:00:00+05:30"
7	},
8	"message": "Bulk resolve completed for 2 conversation(s)"
9	}

Code Snippets & Examples

1	curl -X POST "https://app.chatofy.in/api/v1/inbox/bulk" \
2	-H "Authorization: Bearer YOUR_API_KEY" \
3	-H "Content-Type: application/json" \
4	-d '{"conversation_ids":["conv-8888-9999-aaaa-bbbbccccdddd","conv-1111-2222-3333-444455556666"],"action":"resolve"}'