Skip to main content
PATCH
Manage Inbox
更新单个收件箱的 display_name 和 metadata,地址本身不可改。返回更新后的完整收件箱。写入的是共享 AgentMail 工作区:所有 AIsa 调用方共用同一个 AgentMail 账号,因此这里会触及其他调用方创建的收件箱,你写进去的东西下一个调用方也看得到、改得动。 只读不改用 get_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.

路径参数

inbox_id
string
必填

收件箱的 ID。

请求体

application/json

Expects an object; provide at least one of display_name, status, or metadata.

display_name
string

显示名称:Display Name <username@domain.com>。

status
enum<string>

paused stops the inbox sending and receiving mail; active resumes it. Mail that arrived while the inbox was paused is not delivered on resume.

可用选项:
active,
paused
metadata
UpdateMetadata · object | null

Metadata to merge into the inbox's existing metadata. Keys you include are added or overwritten; keys you omit are left unchanged. To remove a single key, send it with a null value. To clear all metadata, send metadata as null. Sending an empty object is rejected; use null to clear. Each update must include at least one of display_name, status, or metadata.

响应

状态码为 200 的响应

pod_id
string
必填

Pod ID。

inbox_id
string
必填

收件箱的 ID。

email
string
必填

收件箱的电子邮件地址。

updated_at
string<date-time>
必填

收件箱上次更新的时间。

created_at
string<date-time>
必填

收件箱的创建时间。

display_name
string

显示名称:Display Name <username@domain.com>。

client_id
string

收件箱的客户端 ID。

status
enum<string>

paused when the inbox is paused. Omitted when the inbox is active. Treat any value other than paused as an inbox that sends and receives normally.

可用选项:
active,
paused
metadata
Metadata · object

附加到收件箱的自定义元数据。