# 名单

Source: https://docs.simail.ai/zh/api/lists/

> 发信、收信和回复用的允许名单与拦截名单。agent 可以读取并收紧名单；只有人能放宽。

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

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

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

```json
{ "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`（只能收紧）。