Documentation menu
self-serve
DELETE/v1/keys/self
API key required, sent as Authorization: Bearer snk_….
What it does
Authority is the key itself, presented as Authorization: Bearer snk_…. Refused for operator keys (403), OAuth access tokens (403: a
connected app must not be able to delete the account it was granted),
maps-scoped browser keys (403, by the scope classifier) and a key in
?api_key= (400: the key is revoked by this call, but it should not
land in access logs on the way).
Call it
bash
curl -fsS -X DELETE "https://api.mapmap.ai/v1/keys/self" \
-H "Authorization: Bearer $MAPMAP_KEY"Responses
200Account deleted (or already deleted by an earlier call with this key): every key revoked, personal data erased. The body lists what was erased and what is kept
| Field | Type | Required | Description |
|---|---|---|---|
| already_deleted | boolean | yes | true when this was a retry with a key the endpoint had already
revoked; nothing was changed by this call. |
| deleted | boolean | yes | Always true on a 200: the calling key and every key of its
account are revoked. |
| email_erased | boolean | yes | Whether the account's email address was erased. false only for
the store-review identity (see review_identity). |
| erased | string[] | yes | What was erased. |
| forfeited_credit_pence | integer | yes | Prepaid credit left on the account when it was deleted, in pence. It is not refunded by this endpoint. |
| keys_revoked | integer | yes | Keys revoked by this call (0 on a retry). |
| message | string | yes | One sentence for a person. |
| retained | string[] | yes | What is kept, and why. |
| review_identity | boolean | yes | true for the App Review identity: its keys are revoked and its IP
addresses and user agents erased, but the account, its email and
its review label are kept so the reviewer can sign up again with
the same address and get the same verified key. |
400Key sent as
?api_key= rather than as a bearer401Missing, unknown or expired key, or a key revoked by something other than this endpoint
403Operator (
admin) key, OAuth access token, or maps-scoped key409The account has a live subscription; cancel it first
429Per-key rate limit
Error bodies follow the shared problem model documented on API conventions.
Also under self-serve
Generated from https://api.mapmap.ai/openapi.json on 2026-09-30 · operationId delete_self