> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dalyenergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Energy Model

> Execute an energy-model run synchronously or queue it asynchronously

# POST /energymodels

This is the canonical run endpoint for Daly energy-model execution.

## Notes

* The request body is `EnergyModelInput`.
* Current output controls follow the canonical contract documented in
  [Energy Model Response Contracts](/api-reference/energy-model-response-contracts),
  including `output.blockIndex`, `output.blockResults`,
  `output.lossBreakdownTimestamps`, and `output.irradianceLossDetail`.
* Sync execution is the default.
* Add `?async=true` to queue background processing immediately.
* The response is `200` on success for both completed and queued execution paths.
* For rerunning an existing saved row in place, use `POST /energymodels/{energy_model_id}/run` instead.