Documentation menu
POST/v1/keys/verify
Access and price
| Auth | No key. Not metered. |
|---|---|
| Price | Not metered: no quota, no credit. |
What it does
Confirms the ONE key a link was mailed for, upgrading it to the verified free tier (or the plan already bought). Only an explicit press of the page's button reaches this (review of #1339, H1).
No key. Not metered.
Call it
curl -fsS -X POST "https://api.mapmap.ai/v1/keys/verify" \
-H "Content-Type: application/json" \
-d '{"token":"string"}'Request body
application/json · VerifyTokenBody
| Field | Type | Required | Description |
|---|---|---|---|
| token | string | yes | The single-use token from the emailed link (the #t= fragment, or
the ?token= query of a link sent before the fragment form). |
Example: A request assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"token": "string"
}Responses
| Field | Type | Required | Description |
|---|---|---|---|
| monthly_quota | integer | no | The applied monthly quota after a confirmation (a plan bought before confirming is honoured, not the free tier); absent after a refusal. |
| state | string | yes | verified after a confirmation, revoked after "This wasn't me". |
Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"state": "string"
}application/problem+json · Problem
application/problem+json · Problem
text/plain
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 confirm_key