POST/v1/static-map

API key required, sent as api_key.

Call it

bash

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

Request body

application/json

The GeoJSON overlay itself; a Feature, FeatureCollection, bare geometry, or an array of those. Not an envelope object. Every other parameter still travels in the query string

The OpenAPI document declares this body as a free-form JSON object with no field list, so there is nothing here to generate a table from. The prose above is what the gateway states about it; the raw document is the authority.

Responses

200The rendered image, with the renderer's own ETag and Cache-Control

400The renderer rejected the parameters or the overlay (problem+json); no image was drawn and the units are returned

404style named a hosted style id this deployment does not host (problem+json); refused before any render, so the units are returned

504The renderer produced no image within the deadline (problem+json); a cold start, so retry once

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

Also under static-maps

GET /v1/static-map

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