Poser un tag sur une conversation

POST

/api/threads/{key}/tags

• Production

Fournissez soit tag_id (tag existant), soit name — le tag est alors créé s’il n’existe pas encore (avec color, optionnelle). Poser un tag déjà présent est sans effet (idempotent).

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).

Request Body^required

object

tag_id

Id d’un tag existant. Requis si name est absent.

string format: uuid

name

Nom du tag à poser (créé au besoin). Requis si tag_id est absent.

string

<= 80 characters

color

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

Responses

200

Conversation mise à jour, avec ses tags.

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.

422

Corps de requête invalide (erreurs de validation Laravel).

object

message

string

errors

object

key

additional properties

Array<string>

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