Skip to main content
DELETE
/
conversations
/
{id}
/
tags
/
{tag}
Remove a tag from a conversation
curl --request DELETE \
  --url https://api.getfernand.com/conversations/{id}/tags/{tag} \
  --header 'X-API-Key: <api-key>'
{
  "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"
}

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.

Disassociates a tag from a conversation. The tag itself is not deleted and can still be used on other conversations. If the tag is not currently on the conversation, nothing will be done.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Path Parameters

​
id
integer<int64>
required

ID of the conversation to untag.

​
tag
string
required

Name or slug of the tag to remove from the conversation.

Response

Tag removed successfully. Returns the updated conversation.

​
id
integer<int64>
required

Unique identifier for the conversation

Example:

12345

​
contact_id
integer<int64>
required

ID of the primary contact who initiated the conversation

Example:

789

​
subject
string
required

Subject line of the conversation, derived from the first message or manually set

Maximum string length: 250
Example:

"Question about billing"

​
status
enum<string>
required

Current status of the conversation

Available options:
OPENED,
CLOSED,
SPAM,
SNOOZED
Example:

"OPENED"

​
last_update
string<date-time>
required

ISO 8601 timestamp of the last incoming message in the conversation

Example:

"2026-01-21T14:30:00Z"

​
tags
integer<int32>[]
required

Array of tag IDs associated with this conversation

Example:
[1, 5, 12]
​
recipients
object[]
required

Array of recipients in the conversation (to, cc, bcc)

​
agent_id
integer<int64> | null

ID of the agent assigned to this conversation, or null if unassigned

Example:

42

​
channel_id
integer<int64> | null

ID of the channel through which this conversation is conducted

Example:

1

​
snooze_until
string<date-time> | null

ISO 8601 timestamp indicating when a snoozed conversation should reappear, or null if not snoozed

Example:

"2026-01-22T09:00:00Z"

​
cursor
string | null

Pagination cursor for retrieving the next page of conversations in a list

Example:

"cur_1234567890"