Environments API

Create, inspect, snapshot, reset, and archive environments.

Method	Path	Description
POST	/v1/environments	Create from a spec, template, or snapshot.
GET	/v1/environments	List environments in the workspace.
GET	/v1/environments/{id}	Retrieve an environment.
PATCH	/v1/environments/{id}	Update network parameters or metadata.
POST	/v1/environments/{id}/snapshots	Create a snapshot.
POST	/v1/environments/{id}/reset	Reset to a snapshot.
GET	/v1/environments/{id}/state	Read state at the head or a given block.
DELETE	/v1/environments/{id}	Archive.

Create

httphttp

POST /v1/environments
{
  "name": "checkout-flow",
  "template": "evm-basic",
  "network": { "blockTime": "2s" },
  "accounts": 8
}

httphttp

POST /v1/environments/env_7f3a2c/reset
{ "snapshot": "snap_0001" }

Reset responds with the environment at its new head. Run records created after the target snapshot remain retrievable through the runs endpoint.