Execution API

Execute operations and scenarios; retrieve runs, diffs, and traces.

Method	Path	Description
POST	/v1/environments/{id}/execute	Execute a list of operations as a run.
POST	/v1/environments/{id}/scenarios/{scn}/run	Run a scenario.
GET	/v1/runs/{run}	Retrieve a run with status and summary.
GET	/v1/runs/{run}/diff	Structured state diff.
GET	/v1/runs/{run}/trace	Full call trace.
GET	/v1/runs/{run}/events	Events emitted during the run.

Execute

httphttp

POST /v1/environments/env_7f3a2c/execute
{
  "snapshot": true,
  "ops": [
    { "type": "call", "to": "Vault", "fn": "deposit", "from": "user_1", "args": ["250"] },
    { "type": "advance", "blocks": 1 }
  ]
}

responsejson

{
  "id": "run_0419",
  "status": "ok",
  "from": "snap_0014",
  "to": "snap_0015",
  "summary": { "ops": 2, "writes": 3, "events": 2, "gasUsed": 51204 }
}

Run status

ok — every operation completed as specified.
reverted — one or more operations reverted; the run is still fully recorded.
failed — the run could not be executed (invalid operation, missing artifact, limit exceeded).