list_threads
List conversations.
The mailbox: received exchanges and individual messages, newest first. Campaign sends on their own stay in campaign_history; as soon as a reply arrives, the conversation shows here with its context. Statuses: open, replied, bounced, unsubscribed, closed. With unanswered = true: threads waiting for your reply, new received messages (open) included. Cursor pagination.
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 |
|---|---|---|---|
inbox_id | string | no | A single inbox (inb_…). |
status | one of open, replied, bounced, unsubscribed, closed | no | A single status. |
unanswered | boolean | no | true: only threads whose last message is a received e-mail that nothing has been written back to yet (a reply, or a first e-mail). |
archived | boolean | no | true: archives; false: conversations not archived. |
unread | boolean | no | true: unread received messages; false: read ones. |
label | string | no | Exact tag. |
folder | one of received, sent, drafts | no | A folder of the mailbox, as the workbench shows it. |
since | string | no | Threads active since this date. |
query | string | no | Search: part of the correspondent’s address, of their name or of the subject. |
cursor | string | no | Cursor of the next page: the next_cursor value from the previous call. |
limit | integer | no | Number of items returned (20 by default). |
Call it
curl -s https://api.subagent.fr/v1/list_threads \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sak_…' \
-d '{}'The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/list_threads.
This page in Markdown: /en/mail/docs/reference/list_threads.md
All the docs for an agent: /en/mail/docs/llms.txt
Legal notice · Terms · Privacy · Service status