Maps

Change a kept map

update_map

Change a kept map in place: add or remove layers, move or add pins, recolour, rename; the link stays the same and earlier versions are kept.

Use it when

✓ Correcting or extending a map made earlier
✓ Recolouring by a different field

Not for

→ Making a new map: render_map

Coverage: Worldwide.

Inputs

map

string · required

The map_id or link render_map returned.

title

string

A new title.

add_layers

array

—

remove_layers

array

Names of layers to remove.

update_layers

array

—

upsert_points

array

Move, rename or re-field a pin by its id, or add a new one (new pins need lat/lng or an address).

remove_points

array

—

legend

boolean

—

revert_to

integer

Put this earlier version back (it becomes the newest version; nothing is lost).

The full description, as the server gives it to an agent

Change a map made with render_map (or a tool's render): add or remove layers; move, rename or add pins (by id, with lat/lng or an address); remove pins; recolour a layer (one colour, or by a field's values, with colours per value if wanted, or by a number in the user's own bands: bins); show or hide names or a whole layer; rename the map. Several changes in one call. The link stays the same, and every earlier version is kept: revert_to puts one back. get_map lists the layers, pin ids and fields.

A real answer

Captured from the live server on 2026-10-13, trimmed to the first rows.

Request

{
  "map": "9hd9pnytqs",
  "upsert_points": [
    {
      "layer": "Rows",
      "id": "harrogate",
      "name": "Harrogate depot",
      "lat": 53.9921,
      "lng": -1.5418
    }
  ]
}

The answer's first line

Updated "Docs example: two depots" to version 2: added harrogate to "Rows". Same link: https://get-instamaps.com/v/9hd9pnytqs

The answer (trimmed)

{
  "map_id": "9hd9pnytqs",
  "url": "https://get-instamaps.com/v/9hd9pnytqs",
  "geojson": "https://get-instamaps.com/v/9hd9pnytqs.geojson",
  "kml": "https://get-instamaps.com/v/9hd9pnytqs.kml",
  "version": 2,
  "changes": [
    "added harrogate to \"Rows\""
  ],
  "layers": [
    {
      "name": "Rows",
      "points": 3,
      "lines": 0,
      "areas": 0
    }
  ]
}

Use it in Claude

Add the connector https://get-instamaps.com/mcp and ask in plain words. 5,000 tool calls a day per person, reset at midnight UTC; a call counts once however many rows it carries; a sheet by reference is one call; checking a job is free.

How to add it →