Maps

Create Map Endpoint

Create a new map.

post/maps/

Request

  • The document declares no server URL.
  • Auth: one of:
    • OAuth 2 (password, token URL /api/auth/login)
    • API key in header X-Api-Key
    • API key in query parameter api_key

Request body

namestring required

Map display name

descriptionstring nullable

Short description for sharing

notesstring nullable

Private notes (not shown publicly)

Example request

{
  "name": "NYC Infrastructure",
  "description": "Buildings, parks, and transit routes in Manhattan"
}

Response

Successful Response

idstring uuid required
namestring required
descriptionstring nullable required
notesstring nullable
center_lngnumber nullable required
center_latnumber nullable required
zoomnumber nullable required
bearingnumber required
pitchnumber required
basemap_stylestring required
show_basemap_labelsboolean required
visibility'private' | 'internal' | 'public' required
thumbnail_urlstring nullable
og_image_urlstring nullable
forked_from_idstring uuid nullable

Source map UUID if this is a fork

forked_from_namestring nullable
created_bystring uuid nullable required
created_by_usernamestring nullable
created_atstring date-time required
updated_atstring date-time required
layer_countinteger required
pluginsstring[] nullable
legend_titlestring nullable

Changes

No recorded changes to this operation across all 50 revisions of this API.