POST/v1/keys/self/email/verify

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

What it does

Only the key that asked for the code can redeem it. An address that already has ANY identity row is NEVER attached, whether or not anybody ever verified it, and nothing moves between identities: the answer is 409 email-in-use. The app should then sign in with that address through POST /v1/keys, which the owner's own mailbox verifies; that is a new key on the address's identity, so the email-less key's own state (its usage, styles and jobs) does not come with it. A wrong code counts against identity::MAX_EMAIL_CODE_ATTEMPTS (then the code is void), and attempts are capped per key and per IP per day like every other verification budget.

Call it

bash

curl -fsS -X POST "https://api.mapmap.ai/v1/keys/self/email/verify" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · VerifyEmailCodeRequest

Field	Type	Required	Description
code	string	yes	The code from the mail.

Responses

200Address attached; this key is now verified on the free tier

Field	Type	Required	Description
email	string	yes	The address now on the account.
monthly_quota	integer	yes	Requests allowed per calendar month from now on.
state	string	yes	Always `verified`.

400Wrong, used, expired or voided code, or a code another key asked for

401Missing, unknown, revoked or expired key

409key-has-email: the key already has an email; email-in-use: the address belongs to another account, which is left untouched

429Per-key or per-IP daily attempt limit, or the key's per-minute rate limit

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

Also under self-serve

GET /v1/jobs GET /v1/jobs/{id}POST /v1/keys DELETE /v1/keys/self GET /v1/keys/self POST /v1/keys/self/email POST /v1/keys/self/webhook-secret GET /v1/keys/verify POST /v1/keys/verify POST /v1/keys/verify/deny POST /v1/keys/verify/details GET /v1/usage POST /v1/x402/topup

Generated from https://api.mapmap.ai/openapi.json on 2026-10-02 · operationId verify_email_code