Lister les conversations de l'agent

GET

/api/threads

Production

Les 50 conversations les plus récentes de l’agent, avec leurs tags.

Authorizations

apiKey

Responses

200

Liste des conversations.

object

threads

Array<object>

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

401

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

object

error

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

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