`readTerrain`

Read Terrain

Read the owner's Terrain - the living map of their fleet in the Agents panel - as JSON, plus everything that has been sculpted onto it.

read

Arguments

sinceRevisionnumberoptionalReturn `deltas` covering only what has been sculpted AFTER this revision. Omit for the whole terrain with no diff.

Returns

Returns plots (one per PROJECT, keyed the way the map keys them: repo:owner/name for a repo, project:<id> for a Cloud Project, studio:<id> for a Studio app, and one shared bucket for work…

Ask for it

The Cloud routes these requests to this verb.

what does my terrain look like
show me the fleet map
read the terrain
which plots are on my map
what has been sculpted
what changed on the map since

Pair it with

The verbs that finish the job.

shapeTerrain
placeOnTerrain
focusTerrain
animateTerrain
listAgentSessions