> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peeker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How swaps work

> Standard vs premium domain swaps, quotas, cooldowns, and sender renames.

A domain swap replaces one domain inside an existing order without losing the
order. IDs look like `swp_01HZX`.

To change mailbox personas without changing the domain, use
[Rename inbox senders](/guides/user-name-swaps) instead.

## Statuses

| Value             | Meaning                                |
| ----------------- | -------------------------------------- |
| `created`         | Accepted                               |
| `in_progress`     | Work in progress                       |
| `completed`       | New domain is up. Old domain detached. |
| `failed`          | Cannot finish automatically            |
| `action_required` | Needs your help                        |

Subscribe to `swap.*` [webhooks](/webhooks) or poll `GET /swaps/{id}`.

<Note>
  A second swap on a seat that already has one in flight is rejected with `400 invalid_request`. If
  a duplicate is detected later during processing, that swap surfaces as `failed`.
</Note>

## Standard vs premium

| Type       | Behavior                                                         |
| ---------- | ---------------------------------------------------------------- |
| `standard` | Retires the old domain during cutover                            |
| `premium`  | Keeps the old domain warm for **14 days** beside the replacement |

### Premium rules

* Microsoft domains only. Use `standard` for Google.
* Rolling **30-day** allowance: `floor(active Microsoft licenses × tier%)`.
* Tiers: Base **0%** / Premium **10%** / VIP **20%** / VIP+ **30%**.
* Partner API accounts are **VIP+ (30%)**.
* Cooldown is **30 days per seat** (order / Microsoft subscription slot), not
  per domain name.
* Premium replacement domains must already have been **bought through Peeker**.

Use a `standard` swap for imported domains or names Peeker should buy.

## Sender renames

`POST /swaps/user_names` keeps the domain and regenerates mailbox identities
from new personas. Only `first_name` and `last_name` are required.

See [Rename inbox senders](/guides/user-name-swaps).