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"
}
]
}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.Documentation Index
Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt
Use this file to discover all available pages before exploring further.
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?