Blueprints

Change a sheet's scale or features

Change a sheet's scale, or replace its features.

To replace features, send back the geojson you read with GET, edited, together with that read's revision as base_revision. If the sheet changed in between, the save is refused with 409 stale_sheet and nothing is written. Read it again and redo the edit. A scale-only update writes no features.

put/v1/blueprints/{blueprint_id}

Request

  • Base URL: https://api.kamai.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.kamai.io/v1/blueprints/{blueprint_id}
  • Auth: HTTP bearer

Path parameters

blueprint_idstring required

Request body

geojsonobject nullable

Replacement feature collection in the coarse feature shape (the same shape a read returns). Validated for structural integrity — duplicate ids, broken/cyclic hierarchies and geometry that disagrees with its kind are rejected — before it is written to the SQL store.

base_revisionstring nullable

The revision the client's copy of the sheet was read at (from GET or the previous PUT). When given with geojson and the sheet has changed since (the assistant or an MCP client wrote to it), the save is refused with 409 stale_sheet and nothing is written. Omitted, the save is unconditional, as before.

Response

Successful Response

messagestring required

Update confirmation message

revisionstring nullable

The sheet's revision this copy was read at. Send it back as base_revision on a PUT that carries geojson: if the sheet changed in between, that save is refused with 409 stale_sheet instead of silently undoing the change. Opaque; compare for equality only.

Changes

No recorded changes to this operation across all 1 revision of this API.