---
title: "Schedule account deletion"
method: DELETE
path: "/v1/account"
tags: ["account"]
---

# Schedule account deletion

`DELETE /v1/account`

## Request

- Base URL: `https://botmail.pro`
- URL: `https://botmail.pro/v1/account`
- Auth: API key in cookie `bm_session`

Signed-in human (session cookie) only. Starts a 30-day grace period:
sending stops, API keys and OAuth tokens are revoked, mail still arrives.
Body must be `{"confirm": "DELETE MY ACCOUNT"}` (else 400 confirmation_required).

## Request body

- object
  - `confirm` 'DELETE MY ACCOUNT', required

## Response `202`

Deletion scheduled.

- object
  - `status` 'scheduled', required
  - `due_at` string, date-time, required
  - `hint` string, required

## Other responses

- `400`: Invalid request (`bad_request` or a more specific code).
- `401`: Missing or invalid credentials (`unauthorized`, `invalid_token`).
- `403`: The credential can't do this (`forbidden`, `csrf`, `account_inactive`, …). Missing scopes are listed in `details.required_scope`; pending keys get a hint to wait for the claim.
- `409`: Conflicts with current state.

---

[API](https://skmtc.dev/botmail/apis/botmail-api.md) · [All operations](https://skmtc.dev/botmail/apis/botmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/botmail/apis/botmail-api/revisions/49f736362bf2?raw)