curl --request POST \
--url https://api.getfernand.com/conversations/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ids": [
123
]
}
'{
"conversations": [
{
"id": 12345,
"contact_id": 789,
"subject": "Question about billing",
"status": "OPENED",
"last_update": "2026-01-21T14:30:00Z",
"tags": [
1,
5,
12
],
"recipients": [
{
"id": 12345,
"contact_id": 789,
"kind": "cc",
"conversation_id": 456
}
],
"agent_id": 42,
"channel_id": 1,
"snooze_until": "2026-01-22T09:00:00Z",
"cursor": "cur_1234567890"
}
]
}curl --request POST \
--url https://api.getfernand.com/conversations/bulk \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"ids": [
123
]
}
'{
"conversations": [
{
"id": 12345,
"contact_id": 789,
"subject": "Question about billing",
"status": "OPENED",
"last_update": "2026-01-21T14:30:00Z",
"tags": [
1,
5,
12
],
"recipients": [
{
"id": 12345,
"contact_id": 789,
"kind": "cc",
"conversation_id": 456
}
],
"agent_id": 42,
"channel_id": 1,
"snooze_until": "2026-01-22T09:00:00Z",
"cursor": "cur_1234567890"
}
]
}Array of conversation IDs to update.
New status for the conversations. DELETE will permanently delete them.
OPENED, CLOSED, SPAM, SNOOZED, DELETE When status is SNOOZED, specifies when to unsnooze. Formats:
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.
50Tag name to remove from the conversations.
When marking as SPAM, whether to also block the contact (requires contact.block permission).
Conversations updated successfully.
Array of successfully updated conversations.
Show child attributes
Was this page helpful?