> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

# Как использовать Pods для мультитенантной почты?

Pod — изолированное рабочее пространство: свои ящики, домены, треды и черновики, отдельно от других Pods.

## Когда нужны Pods

* **SaaS:** у каждого клиента свои агенты и ящики
* **Агентства:** изоляция по клиентам
* **Платформы агентов:** отдельные workspace
* **White-label:** почта под брендом конечного пользователя

Если почта только для одной организации, Pods необязательны.

## Иерархия

```
Organization (your business)
    └── Pod (Customer A)
        ├── Inbox: support@customera.com
        ├── Inbox: sales@customera.com
        └── Domain: customera.com
    └── Pod (Customer B)
        ├── Inbox: hello@customerb.com
        └── Domain: customerb.com
```

Данные между Pods не пересекаются.

## Создание Pod и ресурсов

**`Python`**

```python title="Python"
from agentinbox import Agentinbox

client = Agentinbox()

pod = client.pods.create(name="Acme Corp")

support_inbox = client.pods.inboxes.create(
    pod_id=pod.pod_id,
    username="support",
    domain="acme.com",
    display_name="Acme Support"
)

sales_inbox = client.pods.inboxes.create(
    pod_id=pod.pod_id,
    username="sales",
    domain="acme.com",
    display_name="Acme Sales"
)
```

> **Note**
>
> Используйте `client_id` у Pod как ваш внутренний ID клиента — не нужна отдельная таблица соответствий.

**`Python`**

```python title="Python"
pod = client.pods.create(
    name="Acme Corp",
    client_id="customer_12345"
)
```

## Ресурсы внутри Pod

**`Python`**

```python title="Python"
inboxes = client.pods.inboxes.list(pod_id=pod.pod_id)
threads = client.pods.threads.list(pod_id=pod.pod_id)
drafts = client.pods.drafts.list(pod_id=pod.pod_id)
```

## Удаление Pod

Сначала удалите ящики и домены — пустой Pod удалить можно.

**`Python`**

```python title="Python"
inboxes = client.pods.inboxes.list(pod_id=pod.pod_id)
for inbox in inboxes.inboxes:
    client.inboxes.delete(inbox.inbox_id)

client.pods.delete(pod_id=pod.pod_id)
```

> **Warning**
>
> Удаление ящика удаляет связанные сообщения, треды и черновики.

## Важно

* **Почта между Pods** ходит как между обычными адресами; изоляция — в доступе к API и данным, не в доставке.
* **Ящик нельзя перенести** между Pods — создайте новый в целевом Pod.
* **Ключи pod** и **ключи ящика** — см. `POST /pods/{pod_id}/api-keys` и `POST /inboxes/{inbox_id}/api-keys`.
* **Лимита на число Pods нет.**
* **Домен** привязан к одному Pod или ко всем, но не к подмножеству Pods.

Подробнее: [Pods](/pods).