API 参考
Pod
读取 pod，并使用邮箱、线程、草稿、名单和 webhook 接口的 pod 级变体。创建和删除 pod 只能由人完成。
docs.simail.ai/zh/api/pods
pod 把一个组织里的邮箱分组。每个组织都有一个 default pod。pod 级 key 只能看到自己这个 pod 里的邮箱。
{ "pod_id": "pod_01JZX3S5V7W9X1Y3Z5A7B9C1D4", "name": "default", "client_id": null, "created_at": "2026-10-18T16:40:00Z", "updated_at": "2026-10-18T16:40:00Z" }列出 pod
Section titled “列出 pod”GET
/v0/pods权限 inbox_read。分页；返回 { count, limit, next_page_token?, pods }。
读取一个 pod
Section titled “读取一个 pod”GET
/v0/pods/{pod_id}权限 inbox_read。
创建或删除 pod
Section titled “创建或删除 pod”POST /v0/pods · DELETE /v0/pods/{pod_id}
只能由人做（403 human_required）。人在控制台里创建和删除 pod。
pod 里的邮箱
Section titled “pod 里的邮箱”GET /v0/pods/{pod_id}/inboxes · POST /v0/pods/{pod_id}/inboxes
GET /v0/pods/{pod_id}/inboxes/{inbox_id} · PATCH /v0/pods/{pod_id}/inboxes/{inbox_id} · DELETE /v0/pods/{pod_id}/inboxes/{inbox_id}
GET
/v0/pods/{pod_id}/inboxes/search正文、权限和响应与邮箱相同，范围限在这个 pod。在这里创建的邮箱属于这个 pod。
其他 pod 变体
Section titled “其他 pod 变体”线程、草稿、名单和 webhook 都有 pod 变体，形状与组织级接口相同，范围限在这个 pod：
| pod 变体 | 等同于 |
|---|---|
GET /v0/pods/{pod_id}/threads、…/threads/search、…/threads/{thread_id}、…/threads/{thread_id}/attachments/{attachment_id} | /v0/threads… |
GET /v0/pods/{pod_id}/drafts、…/drafts/{draft_id} | /v0/drafts… |
/v0/pods/{pod_id}/lists/… | /v0/lists/… |
/v0/pods/{pod_id}/webhooks… | /v0/webhooks… |
/v0/pods/{pod_id}/domains 返回 501 not_implemented。