Documentation menu
DELETE/v1/keys/self
Access and price
| Auth | An 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. |
|---|---|
| Price | Not 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
curl -fsS -X DELETE "https://api.mapmap.ai/v1/keys/self" \
-H "Authorization: Bearer $MAPMAP_KEY"Responses
key_verified: false) it is the same whichever happened, with email_erased, keys_remaining and forfeited_credit_pence null| 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 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_erased | boolean | no | Whether 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. |
| erased | string[] | yes | What was erased. |
| forfeited_credit_pence | integer | no | Prepaid 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_verified | boolean | yes | Whether 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_remaining | integer | no | Active 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_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: 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
{
"already_deleted": false,
"deleted": false,
"erased": [
"string"
],
"key_verified": false,
"keys_revoked": 0,
"message": "string",
"retained": [
"string"
],
"review_identity": false
}?api_key= rather than as a bearerapplication/problem+json · Problem
unauthorized)application/problem+json · Problem
admin) key, OAuth access token, or maps-scoped keyapplication/problem+json · Problem
application/problem+json · Problem
application/problem+json · Problem
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