DELETE · Email
Hold a mailbox deletion for confirmation
Hold a mailbox deletion for confirmation
DELETE
/api/v1/email/account
Description
Confirms the mailbox exists and reads its usage, then returns {status:"confirmation_required", confirmationUrl, …}. It deletes nothing on this call.
Query parameters
| Name | Type | Description |
|---|---|---|
address
required
|
string |
The full mailbox address to delete, e.g. [email protected].
|
attempt_key
|
string | Idempotency key for this intent. Keep it stable across retries so a timed-out retry cannot buy the same thing twice. Up to 128 characters. |
Responses
A 200 response returns the shape shown in the rail.
Every non-2xx response is an RFC 7807 problem with a stable
code.
Commonly returned errors
The codes this operation reaches on its own path: the auth stack, its own validation and
ownership checks, and the transport. Not a closed set — a shared code from the
full registry can still surface. Each links to the code’s own page,
the same URL its type dereferences to.
401
No token was presented, or the token is revoked, expired or unknown.
403
The token lacks a required scope, or this account does not own the resource.
422
Validation error
429
The rate limit for this token is exhausted. See `Retry-After`.
500
Something went wrong on our side. The failure is logged against `requestId`.