> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# `classify_thread`

> Ajoute ou retire les tags d’une conversation (labels remplace la liste complète), archive ou restaure le fil, marque les messages reçus comme lus ou non lus.

## En bref

| Propriété | Valeur |
|---|---|
| Titre | Classer une conversation |
| Outil MCP | `classify_thread`, sur `https://api.subagent.fr/mcp` |
| Appel HTTP | `POST https://api.subagent.fr/v1/classify_thread` |
| Accès | permission `send` ou `approve` |
| État de l'espace | vérifié ou non |
| Effet | écriture |
| Vue dans l'assistant | oui : voir [Vues](https://subagent.fr/docs/vues.md) |

## Ce que fait l'outil

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

> Ajoute ou retire les tags d’une conversation (labels remplace la liste complète), archive ou restaure le fil, marque les messages reçus comme lus ou non lus. Ne modifie ni les messages, ni les blocages, ni leur statut de livraison.

## Paramètres

`classify_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 | Conversation à classer. |
| `labels` | liste | non |  |
| `archived` | booléen | non | Archiver ou restaurer. |
| `read` | booléen | non | Marquer comme lu ou non lu. |

## 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 |
|---|---|---|
| `thread` | objet | Un fil. Voir [les champs d'un fil](https://subagent.fr/docs/fils.md#champs). |

## Exemple d'appel

Les valeurs sont fictives.

HTTP :

```sh
curl -X POST https://api.subagent.fr/v1/classify_thread \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97",
  "labels": [
    "devis"
  ],
  "archived": false
}'
```

MCP (`tools/call`) :

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "classify_thread",
    "arguments": {
      "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97",
      "labels": [
        "devis"
      ],
      "archived": false
    }
  }
}
```

## Refus possibles

Aucun refus propre à cet outil. Restent les refus communs à tous les outils (`unauthorized`, `forbidden`, `invalid_argument`, `rate_limited`, `internal`) : voir [Erreurs](https://subagent.fr/docs/erreurs.md#acces).

## Voir aussi

- [Fils : classify_thread](https://subagent.fr/docs/fils.md#classify_thread)
- [`list_threads`](https://subagent.fr/docs/reference/list_threads.md)
- [`get_thread`](https://subagent.fr/docs/reference/get_thread.md)
- [Tous les outils](https://subagent.fr/docs/reference/index.md)