Skip to content

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

Documentation menu
docs / api / put-places
places

PUT/places

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

Call it

bash
curl -fsS -X PUT "https://api.mapmap.ai/places" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · PutPlacesRequest

FieldTypeRequiredDescription
placesPlace[]yesThe full dataset; replaces whatever was stored before.

Responses

200Dataset stored and indexed
FieldTypeRequiredDescription
countintegeryesNumber of places stored.
updated_atstringyesRFC 3339 timestamp of this upload.
400Malformed request body
401Missing or invalid API key
404Customer places not configured on this gateway
413More than the per-key place cap
422One or more places failed validation; the body's problems list names each offender

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

Also under places

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