> For an agent: the map of this documentation is at https://escouade.io/en/mail/docs/llms.txt; every page exists in Markdown, at the same address with `.md` appended.

# `classify_thread`

Classify a conversation.

Adds or removes a conversation's tags (labels replaces the whole list), archives or restores the thread, marks received messages as read or unread. Changes neither the messages, nor the blocks, nor their delivery status.

## Access

- **Key**: an Escouade Mail key with `send` or `approve`.
- **Space**: any space, verified or not.
- **Changes nothing**: no, it acts.
- **Safe to replay**: yes.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `thread_id` | string | yes | Conversation to classify. |
| `labels` | list of string | no | The conversation's tags: this list replaces the previous one. |
| `archived` | boolean | no | Archive or restore. |
| `read` | boolean | no | Mark as read or unread. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/classify_thread \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"thread_id": "…"}'
```

The full page in French, with the response fields and every refusal the tool can return: [/mail/docs/reference/classify_thread](https://escouade.io/mail/docs/reference/classify_thread).