get_thread · Documentation Subagent

Lit un fil : ses messages dans l’ordre, entrants et sortants, avec leur texte, leur statut (brouillon, en file, parti, revenu, reçu…) et les réponses automatiques marquées comme telles.

En bref

Propriété	Valeur
Titre	Lire une conversation
Outil MCP	`get_thread`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/get_thread`
Accès	permission `read`
État de l’espace	vérifié ou non
Effet	lecture seule
Vue dans l’assistant	oui : voir Vues

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Lit un fil : ses messages dans l’ordre, entrants et sortants, avec leur texte, leur statut (brouillon, en file, parti, revenu, reçu…) et les réponses automatiques marquées comme telles. À lire avant de répondre (reply_to_thread). Au plus 50 messages par appel (suite : cursor) ; au-delà de 200 Ko de corps au total, les corps suivants sont tronqués et marqués truncated (le message entier : get_message).

Paramètres

get_thread accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`thread_id`	identifiant `thr_…`	oui	Le fil (thr_…).
`cursor`	texte	non	Curseur de la page suivante : la valeur `next_cursor` de l’appel précédent.

Résultat

L’outil rend un texte lisible en français et un objet structuré (structuredContent). En HTTP, la réponse est cet objet.

Champ	Type	Contenu
`messages`	liste	Une liste : des messages. Voir les champs d’un message.
`next_cursor`	texte ou `null`	Curseur de la suite du fil, s’il reste des messages.
`thread`	objet	Un fil. Voir les champs d’un fil.
`truncated`	booléen	`true` : des corps ont été tronqués (200 Ko au plus par appel).

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/get_thread \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97"
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97"
    }
  }
}

Refus possibles

Code	HTTP	Ce qui s’est passé	Que faire
`not_found`	404	L’objet n’existe pas pour cette clé.	Vérifier l’identifiant : il vient de `list_inboxes`, `list_threads`, `get_thread` ou `list_drafts`.

S’y ajoutent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`get_thread`