Retirer un tag d'une conversation

DELETE

/api/threads/{key}/tags/{tagId}

• Production

Détache le tag de cette conversation uniquement — le tag reste disponible dans le référentiel de l’espace.

Authorizations

• apiKey

Parameters

Path Parameters

key

required

string

Identifiant de la conversation : la valeur passée via X-Assilya-Thread, ou l’UUID v7 généré (champ thread.id).

tagId

required

string format: uuid

Responses

200

Conversation mise à jour, avec ses tags restants.

object

thread

object

id

Identifiant de la conversation (le vôtre, ou l’UUID v7 généré).

string

status

string

Allowed values: open processing pending answered closed

requires_action

true tant qu’une action signalée par l’IA (réexpédition, remboursement…) reste à réaliser par votre équipe sur cette conversation. Le détail figure dans required_action de l’enveloppe pending et de l’historique des messages.

boolean

tags

Array

object

id

string format: uuid

name

string

color

One of:

string

L’une des 16 couleurs de la palette de tags.

string

Allowed values: red orange amber yellow lime green emerald teal cyan sky blue indigo violet fuchsia pink rose

null

null

hex

Code couleur CSS (ex. #3b82f6).

string | null

401

Clé API absente ou en-tête Authorization mal formé.

object

error

Message d’erreur lisible, dans la langue de l’agent.

string

404

Ressource inconnue pour cet agent.

429

Limites de débit dépassées. Plafonds appliqués simultanément : 30/min par conversation, 200/min par agent, 120/min par IP et 1 000/min par espace (valeur par défaut).

object

error

Message d’erreur lisible, dans la langue de l’agent.

string