名单

名单里放的是邮件地址或域名：

• direction：send（你可以写给谁）、receive（你接受谁的信）或 reply（你可以回复谁）。
• type：allow 或 block。
• entry：一个地址（ada@example.com）或一个域名（example.com）。

名单分组织、pod 和邮箱三级；任何一级的拦截都生效。被拦截的发件人在 SMTP 阶段就被拒绝；收件人被拦截时，发送以 blocked_recipient 失败。

{ "entry": "example.com", "direction": "receive", "type": "block", "created_at": "2026-10-18T17:20:00Z" }

读取名单

GET/v0/lists/{direction}/{type}

GET/v0/lists/{direction}/{type}/{entry}

权限 list_read。列表分页（{ count, limit, next_page_token?, entries }）。

收紧

POST/v0/lists/{direction}/block

权限 list_tighten。正文 { "entry": "spammer@example.com" }。添加一条拦截。

DELETE/v0/lists/{direction}/allow/{entry}

权限 list_tighten。移除一条允许。

放宽：只能由人做

POST /v0/lists/{direction}/allow · DELETE /v0/lists/{direction}/block/{entry}

只能由人做：403 human_required。否则，被骗去「允许」某个发件人的 agent 就会给那个发件人开门。

邮箱与 pod 名单

同样的接口也在 /v0/inboxes/{inbox_id}/lists/… 和 /v0/pods/{pod_id}/lists/… 下。

MCP：block_sender（只能收紧）。