Skip to content

50,000 free calls a month, card-free. Get an API key →

Documentation menu
docs / api / delete-v1-keys-self
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
FieldTypeRequiredDescription
already_deletedbooleanyestrue when this was a retry with a key the endpoint had already revoked; nothing was changed by this call.
deletedbooleanyesAlways true on a 200: the calling key and every key of its account are revoked.
email_erasedbooleanyesWhether the account's email address was erased. false only for the store-review identity (see review_identity).
erasedstring[]yesWhat was erased.
forfeited_credit_penceintegeryesPrepaid credit left on the account when it was deleted, in pence. It is not refunded by this endpoint.
keys_revokedintegeryesKeys revoked by this call (0 on a retry).
messagestringyesOne sentence for a person.
retainedstring[]yesWhat is kept, and why.
review_identitybooleanyestrue 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 bearer
401Missing, unknown or expired key, or a key revoked by something other than this endpoint
403Operator (admin) key, OAuth access token, or maps-scoped key
409The 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