Consulter une conversation

GET

/api/threads/{key}

Production

Détail d’une conversation : statut, titre, tags et notes internes (des plus récentes aux plus anciennes).

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

Responses

200

Détail de la conversation.

object

thread

object

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

string format: uuid

name

string

color

One of:

string
null

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

hex

Code couleur CSS (ex. #3b82f6).

string | null

title

string | null

notes

Notes internes, des plus récentes aux plus anciennes.

Array<object>

object

string format: uuid

note

string

created_at

string format: date-time

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