---
title: "Admin Retire Mailboxes"
method: POST
path: "/api/outreach/admin/retire-mailboxes"
tags: ["outreach-admin"]
---

# Admin Retire Mailboxes

`POST /api/outreach/admin/retire-mailboxes`

Permanently take mailboxes out of the pool (terminal ``retired`` status).

For boxes we are done with (e.g. returning to the vendor). Unlike a pause,
survives the provider sync and cancels queued replies too.

Staff-only on top of the router's ``require_org_admin``: the router gate
passes any customer who owns their own org, while this action is
irreversible and fleet-wide (``outreach_mailboxes`` is the shared operator
pool, unscoped by org) — it must never be reachable from a self-serve
account.

## Cookies

- `ex_access` string, nullable
- `ex_org` string, nullable

## Request body

- RetireMailboxesBody
  - `emails` string[], required
  - `reason` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explee/explee-api/revisions/aec0744a2cd1/schema)