Skip to content
Documentation menu
docs / api / delete-v1-keys-self
Keys and account

DELETE/v1/keys/self

Access and price

AuthAn API key, as Authorization: Bearer snk_… only. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused.
PriceNot metered: no quota, no credit.

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

200Deleted (or already deleted by an earlier call with this key): a verified key revokes the keys sharing its label, and when no other active key remains the account's personal data is erased too; an unverified key revokes only itself, and erases the account only when it is its sole key. The body lists what was erased, what is kept and how many keys remain; for an unverified key (key_verified: false) it is the same whichever happened, with email_erased, keys_remaining and forfeited_credit_pence null
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 is revoked. A verified key takes every key of its account that carries the same label (the same app) with it; an unverified key only itself.
email_erasedbooleannoWhether the account's email address was erased. false while another active key remains on the account (see keys_remaining), and for the store-review identity (see review_identity). null when the calling key was unverified. Such a key may have been requested by anyone who typed the address, so the answer must not tell it whether anyone else holds a key there: the response is the same whether the account was kept or, the key being the only one ever issued for the address, erased with it. message and retained state both possibilities.
erasedstring[]yesWhat was erased.
forfeited_credit_penceintegernoPrepaid credit left on the account when it was deleted, in pence. It is not refunded by this endpoint. null when the calling key was unverified, for the reason given under email_erased.
key_verifiedbooleanyesWhether the calling key was verified. A verified key speaks for its account and is told what happened to it; an unverified key speaks only for itself and is not (see email_erased).
keys_remainingintegernoActive keys still on the account after this call: another MapMap app's key, or keys created with a different label. Deletion by a verified key is per app, so the account and its email are erased only when this is 0. null when the calling key was unverified, for the reason given under email_erased.
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: 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, and its IP addresses and user agents are erased. A key on it deletes only itself (its address is not a secret, so a key minted by someone else must not be able to revoke the reviewer's); keys_remaining counts the others.

Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "already_deleted": false,
  "deleted": false,
  "erased": [
    "string"
  ],
  "key_verified": false,
  "keys_revoked": 0,
  "message": "string",
  "retained": [
    "string"
  ],
  "review_identity": false
}
400Key sent as ?api_key= rather than as a bearer

application/problem+json · Problem

401Missing, unknown or expired key, or a key revoked by something other than this endpoint. Also: No key, or a missing, malformed, unknown, revoked or expired one (unauthorized)

application/problem+json · Problem

403Operator (admin) key, OAuth access token, or maps-scoped key

application/problem+json · Problem

409This call would delete the whole account while it has a live subscription; cancel it first

application/problem+json · Problem

429Per-key rate limit

application/problem+json · Problem

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

Error bodies follow the shared problem model documented on API conventions.

Also under Keys and account

Generated from https://api.mapmap.ai/openapi.json on 2026-11-18 · operationId delete_self