Conversations

Detach a tag from a conversation

Removes a workspace tag from a conversation.

DELETE

/v2/conversations/{id}/tags/{tagId}

curl --request DELETE \
  --url https://do.featurebase.app/v2/conversations/{id}/tags/{tagId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actingAdminId": "507f1f77bcf86cd799439011"
}
'

{
  "appliedAt": "2025-01-15T10:30:00.000Z",
  "appliedBy": {
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "type": "admin"
  },
  "id": "67ec1234abcd5678ef901234",
  "name": "Churn",
  "removedAt": "2025-01-15T11:00:00.000Z",
  "removedBy": {
    "id": "507f1f77bcf86cd799439011",
    "name": "John Doe",
    "type": "admin"
  },
  "targetPartId": "67890",
  "type": "tag"
}

This endpoint requires the actingAdminId of the admin on whose behalf the mutation is recorded.

Path Parameters

id - The conversation ID (short ID)
tagId - The Featurebase tag ID to remove

Request Body

Field	Type	Required	Description
`actingAdminId`	string	Yes	The admin performing the mutation. Must be a member of the organization.

Behavior

Featurebase resolves the latest taggable reply/message in the conversation and records the tag removal against that part so audit metadata remains deterministic.

Response

Returns the affected tag payload with the most relevant attachment metadata available for that relationship.

Example Request

{
  "actingAdminId": "507f1f77bcf86cd799439011"
}

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de ruta

idstringobligatorio

Conversation ID (short ID)

Required string length: 1 - 16

Patrón: ^[a-zA-Z0-9]+$

Ejemplo: 12345

tagIdstringobligatorio

The Featurebase tag ID to remove from the conversation.

Ejemplo: 67ec1234abcd5678ef901234

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Ejemplo: 2026-08-19.orbit

Cuerpo

actingAdminIdstringobligatorio

Required admin ID performing this tag removal. Must be a member of the organization so the mutation can be attributed to a real admin actor.

Ejemplo: 507f1f77bcf86cd799439011

Respuesta

Success

appliedAtstring | null

ISO timestamp when the tag was applied

Ejemplo: 2025-01-15T10:30:00.000Z

appliedByobject | null

Actor that applied the tag

Mostrar child attributes

idstringobligatorio

Unique tag identifier

Ejemplo: 67ec1234abcd5678ef901234

namestringobligatorio

Current tag name

Ejemplo: Churn

removedAtstring | null

ISO timestamp when the tag was removed, if applicable

Ejemplo: 2025-01-15T11:00:00.000Z

removedByobject | null

Actor that removed the tag, if applicable

Mostrar child attributes

targetPartIdstring | null

Reply/message ID used as the deterministic attachment target for this conversation tag mutation.

Ejemplo: 67890

typeenum<string>obligatorio

Object type identifier for a tag

Opciones disponibles: tag

Ejemplo: tag

¿Aún necesitas ayuda? Pregunta al equipo