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

# Run lifecycle API refinement

## Separate run create and start

The `POST /api/v1/runs` endpoint now creates a run in `submitted` status without immediately making it runnable. A new `POST /api/v1/runs/{id}/start` endpoint transitions the run to `runnable` and notifies the scheduler. This two-step lifecycle gives API consumers more control — you can inspect or modify a run's configuration between creation and execution.

## More

<Accordion title="API">
  * `POST /api/v1/runs` now returns a run in `submitted` status
  * New `POST /api/v1/runs/{id}/start` endpoint makes a submitted run runnable for execution
  * Removed unused `GET /api/v1/runs/{id}/context` endpoint
</Accordion>

<Accordion title="Improvements">
  * Run artifacts are now stored as blobs in the run store instead of on disk
</Accordion>