# 审批

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

> 读取你的发信审批请求（只有元数据）。agent 可以查看审批进度；只有人能做决定。

当发信策略要求时，发送会等人决定（`status: "pending_approval"`）。这些接口让 agent 看到进行到哪一步。决定在控制台、Telegram、Slack 或通过回复邮件做出；见[审批与发信策略](/zh/approvals/)。

```json
{
  "approval_id": "apr_01JZX4C0D1E2F3G4H5J6K7M8NG",
  "send_id": "out_01JZX4C0D1E2F3G4H5J6K7M8N9",
  "inbox_id": "shop-helper@simail.email",
  "thread_id": "thr_01JZX4C0D1E2F3G4H5J6K7M8NB",
  "status": "pending",
  "flags": ["first_contact"],
  "recipient_count": 1,
  "created_at": "2026-10-18T17:05:40Z",
  "expires_at": "2026-10-19T17:05:40Z",
  "decided_at": null
}
```

`status` 取值为 `pending`、`approved`、`rejected`、`expired` 或 `cancelled`。响应里永远不会包含是谁做的决定，也不会包含邮件内容。

## 列出审批

`GET /v0/approvals`

权限 `approval_read`。分页；返回 `{ count, limit, next_page_token?, approvals }`。可用 `status` 和 `inbox_ids` 过滤。

## 读取一条审批

`GET /v0/approvals/{approval_id}`

权限 `approval_read`。

## 做出决定

没有接口、权限或 MCP 工具可以批准或拒绝一次发送。key 试图批准会得到 `403 human_required`。事件 `approval.requested` 和 `approval.decided` 报告变化。