Skip to content

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

Documentation menu
docs / api / post-oauth-register
oauth

POST/oauth/register

Public. No key, and no quota deducted.

Call it

bash
curl -fsS -X POST "https://api.mapmap.ai/oauth/register" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · RegisterClientRequest

FieldTypeRequiredDescription
client_namestringnoDisplay name shown on the consent card.
redirect_urisstring[]yesRedirect URIs this client will use. https anywhere, or http on a loopback address for native/CLI clients.
token_endpoint_auth_methodstringnoMust be "none" when given: this server registers public clients only and issues no client secrets.

Responses

201Client registered
FieldTypeRequiredDescription
client_idstringyesThe issued client id (UUID). There is no client secret.
client_id_issued_atintegeryesUnix timestamp of issuance.
client_namestringyesDisplay name recorded for this client.
grant_typesstring[]yesAlways ["authorization_code","refresh_token"].
redirect_urisstring[]yesThe accepted redirect URIs, echoed.
response_typesstring[]yesAlways ["code"].
token_endpoint_auth_methodstringyesAlways "none" — public clients only.
400No usable redirect URI, or a confidential-client registration
429Registration velocity exceeded
501OAuth not configured on this deployment

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

Also under oauth

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId register_client