Skip to main content
GET
列出会话线程
列出账号下每一个收件箱的会话。返回 count、limit、next_page_token 和 threads,用 next_page_token 翻页。每条含 thread_id、inbox_id、labels、timestamp、senders、recipients、subject、preview、message_count 和 last_message_id。这是账号级视图,跨越账号下的每一个收件箱。所有 AIsa 调用方共用同一个 AgentMail 账号,因此这里会触及其他调用方创建的收件箱;只针对单个收件箱时请用收件箱级的孪生工具 get_agentmail_inbox_threads。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

after
string<date-time>

用于筛选此时间戳之后数据的时间戳。

ascending
boolean

按时间升序排序。

before
string<date-time>

用于筛选的截止时间戳。

include_blocked
boolean

在结果中包含被屏蔽项。

include_spam
boolean

在结果中包含垃圾邮件。

include_trash
boolean

在结果中包含垃圾内容。

include_unauthenticated
boolean

在结果中包含未经身份验证的内容。

labels
string[]

用于筛选的标签。

limit
integer

返回项目数量的上限。

page_token
string

用于分页的页面 token。

recipients
string[]

Filter to threads whose recipients contain this value (substring match). Repeatable; all values must match.

senders
string[]

Filter to threads whose senders contain this value (substring match). Repeatable; all values must match.

subject
string[]

Filter to threads whose subject contains this value (substring match). Repeatable; all values must match.

响应

状态码为 200 的响应

count
integer
必填

返回的项目数量。

threads
ThreadItem · object[]
必填

按 timestamp 降序排列。

limit
integer

返回项目数量的上限。

next_page_token
string

用于分页的页面 token。