get_thread · Escouade Mail documentation

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

Terminal

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.