Maps

Patch Map Layers Endpoint

Apply incremental layer additions, patches, removals, and ordering.

Declared on both slash variants directly, mirroring the POST route below. FastAPI's default redirect_slashes builds a relative Location header that resolves against the request's Host header, which would leak the in-container api:8000 hostname through Vite's dev proxy on a 307 redirect. The canonical (OpenAPI-published) form is the no-slash sub-collection convention documented in the GeoLens API guide (https://docs.getgeolens.com/guides/api/); the trailing-slash form is a hidden alias.

patch/maps/{map_id}/layers

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

Path parameters

map_idstring uuid required

Request body

removedstring[]
orderstring[] nullable

Optional stable layer ID order for existing layers

fallback_full_replaceboolean

Client hint only; PATCH never performs full replacement

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.