Get a scenario's state, inputs and price
get_scenarioGet a scenario's COMPACT state: its computed_status, inputs, estimate and price.
Returns a compact record, never the raw ~50 KB detail: scenario_id,
computed_status, mesh_triangle_count_estimate and its _breakdown,
latest_run_is_valid, the latest run's run_id, run_status,
error_message, user_message, status_detail and mesh_triangle_count
— plus what the scenario IS and what it will cost: name, description,
project, resolution, duration, the input row ids (terrain,
boundary, friction, inflow, rainfall, building, mesh_region),
compute_cost_estimate (USD), vcpu_hours_estimate, and
inflow_anchor_mismatch (null unless an inflow series starts after the
model does, whose first value is then held backwards).
The computed_status field (there is NO status key on a scenario) is
derived from the latest run and will be one of: created, building, built,
queued, computing, processing, complete, error, or cancelled — created
also means no run exists yet. A scenario must be built before it can be
run. latest_run_is_valid is false after any edit since the last build.
A non-member reading a public project's scenario gets a reduced record:
the fields the server withholds (the input ids, the price,
inflow_anchor_mismatch) are ABSENT here rather than reported as null —
"withheld" is not "no terrain, no cost" — while the run-state keys,
computed_status among them, read null.
No presigned S3 URL is returned by any read tool (each is a 6-hour
capability): results stay viewable through a run's gn_layer_* WMS
entries — use get_run for the full run record.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | The project ID | |
| scenario_id | Yes | The scenario ID |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||