# Pod

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

> 读取 pod，并使用邮箱、线程、草稿、名单和 webhook 接口的 pod 级变体。创建和删除 pod 只能由人完成。

pod 把一个组织里的邮箱分组。每个组织都有一个 `default` pod。pod 级 key 只能看到自己这个 pod 里的邮箱。

```json
{ "pod_id": "pod_01JZX3S5V7W9X1Y3Z5A7B9C1D4", "name": "default", "client_id": null, "created_at": "2026-10-18T16:40:00Z", "updated_at": "2026-10-18T16:40:00Z" }
```

## 列出 pod

`GET /v0/pods`

权限 `inbox_read`。分页；返回 `{ count, limit, next_page_token?, pods }`。

## 读取一个 pod

`GET /v0/pods/{pod_id}`

权限 `inbox_read`。

## 创建或删除 pod

`POST /v0/pods` · `DELETE /v0/pods/{pod_id}`

**只能由人做**（`403 human_required`）。人在控制台里创建和删除 pod。

## 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`

正文、权限和响应与[邮箱](/zh/api/inboxes/)相同，范围限在这个 pod。在这里创建的邮箱属于这个 pod。

## 其他 pod 变体

线程、草稿、名单和 webhook 都有 pod 变体，形状与组织级接口相同，范围限在这个 pod：

| pod 变体 | 等同于 |
|---|---|
| `GET /v0/pods/{pod_id}/threads`、`…/threads/search`、`…/threads/{thread_id}`、`…/threads/{thread_id}/attachments/{attachment_id}` | [`/v0/threads…`](/zh/api/threads/#组织范围内的线程) |
| `GET /v0/pods/{pod_id}/drafts`、`…/drafts/{draft_id}` | [`/v0/drafts…`](/zh/api/drafts/#组织范围内的草稿) |
| `/v0/pods/{pod_id}/lists/…` | [`/v0/lists/…`](/zh/api/lists/) |
| `/v0/pods/{pod_id}/webhooks…` | [`/v0/webhooks…`](/zh/api/webhooks/) |

`/v0/pods/{pod_id}/domains` 返回 `501 not_implemented`。