List received threads
list_threadsGroup received mail into conversations by Message-ID, In-Reply-To and References, newest thread first, with each row showing the verdict of its newest message. Use it to review conversation history.
Instructions
Purpose: group received mail into conversations by Message-ID, In-Reply-To and References, newest thread first. Each row carries the verdict of its newest message. Held messages are left out unless include_held is true. NOT for: reading a message body (get_received_email) or sending a reply (reply_to_email). A thread with no Message-ID is listed under its own received id. Returns: data, has_more, and next_cursor. Each row has the thread id, subject, participants, message_count, last_received_at, latest_id and verdict.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_threads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size (1-100). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. | |
| include_held | No | Set true to include threads whose messages are still held. Omitted, held messages are left out. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | This page of rows. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| has_more | No | True when another page follows. | |
| next_cursor | No | Pass back as cursor for the next page; null on the last page. |