API 参考

审批

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

docs.simail.ai/zh/api/approvals

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

{
  "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 报告变化。