Skip to main content
GET
List And Create Inboxes
列出 AgentMail 账号下的全部收件箱。返回 count、limit、next_page_token 和 inboxes,用 next_page_token 翻页。每个收件箱含 inbox_id、email、display_name、client_id、pod_id、metadata、created_at 和 updated_at。所有 AIsa 调用方共用同一个 AgentMail 账号,因此这里会触及其他调用方创建的收件箱,所以这份列表并非按你隔离,返回的收件箱可能属于别人。已知 id 时用 get_agentmail_inbox,新建用 post_agentmail_inbox。

示例

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

费用与请求规则

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.012
  • 计费依据: explicit_zero
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

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

查询参数

ascending
boolean

按时间升序排序。

limit
integer

返回项目数量的上限。

page_token
string

用于分页的页面 token。

响应

状态码为 200 的响应

count
integer
必填

返回的项目数量。

inboxes
Inbox · object[]
必填

按 created_at 降序排列。

limit
integer

返回项目数量的上限。

next_page_token
string

用于分页的页面 token。