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

# `get_thread`

Read a conversation.

Reads a thread: its messages in order, incoming and outgoing, with their text, their status (draft, queued, sent, bounced, received…) and automatic replies marked as such. Read it before replying (reply_to_thread). 50 messages per call at most (next page: cursor); beyond 200 KB of bodies in total, later bodies are truncated and marked truncated (the whole message: get_message).

## Access

- **Key**: an Escouade Mail key with `read`.
- **Space**: any space, verified or not.
- **Changes nothing**: yes, it only reads.
- **Safe to replay**: yes.

## Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `thread_id` | string | yes | The thread (thr_…). |
| `cursor` | string | no | Cursor of the next page: the next_cursor value from the previous call. |

## Call it

```sh
curl -s https://api.subagent.fr/v1/get_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/get_thread](https://escouade.io/mail/docs/reference/get_thread).