---
title: "Run lifecycle API refinement"
date: "2026-04-04"
---

## Separate run create and start

The `POST /api/v1/runs` endpoint now creates a run in `submitted` status without immediately queuing it. A new `POST /api/v1/runs/{id}/start` endpoint transitions the run to `queued` 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 queues a submitted run 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>