Skip to main content
GET
Manage Email Thread
只按 id 获取一条会话,不指定收件箱:thread_id、inbox_id、labels、timestamp、received_timestamp、sent_timestamp、senders、recipients、subject、preview、附件与邮件。因为没有指定收件箱,它是在整个账号范围内解析的。所有 AIsa 调用方共用同一个 AgentMail 账号,因此这里会触及其他调用方创建的收件箱,所以不属于你的 thread id 一样能解析出来——请检查返回的 inbox_id。带范围的孪生工具是 get_agentmail_inbox_thread。

示例

第一次用? 把任意 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.

路径参数

thread_id
string
必填

会话 ID。

查询参数

limit
integer

Maximum number of messages to return. Cannot exceed 100. 返回项目数量的上限。

page_token
string

Token returned by the previous response for retrieving the next, older page. 用于分页的页面 token。

响应

状态码为 200 的响应

inbox_id
string
必填

收件箱的 ID。

thread_id
string
必填

会话 ID。

labels
string[]
必填

会话标签。

timestamp
string<date-time>
必填

最后发送或接收消息的时间戳。

senders
string[]
必填

会话中的发件人。格式为 username@domain.com 或 Display Name <username@domain.com>。

recipients
string[]
必填

会话中的收件人。格式为 username@domain.com 或 Display Name <username@domain.com>。

last_message_id
string
必填

会话串中最后一条消息的 ID。

message_count
integer
必填

会话中的消息数量。

size
integer
必填

线程大小(以字节为单位)。

updated_at
string<date-time>
必填

线程上次更新的时间。

created_at
string<date-time>
必填

会话串的创建时间。

count
integer
必填

Number of messages in this response page.

messages
Message · object[]
必填

Messages in this page, ordered by timestamp ascending. The first page contains the newest messages; follow next_page_token to retrieve older pages.

received_timestamp
string<date-time>

最后收到消息的时间戳。

sent_timestamp
string<date-time>

最后发送消息的时间戳。

subject
string

会话主题。

preview
string

会话中最后一条消息的文本预览。

attachments
Attachment · object[]

线程中的附件。

limit
integer

Maximum number of messages requested for this page.

next_page_token
string

Token for the next, older page of messages. Omitted when this page completes the thread.