---
title: "Changes to Dispatch a simulation suite run (fan-out per item)"
method: POST
path: "/v1/sim-suites/{suite_id}/runs"
---

# Changes to Dispatch a simulation suite run (fan-out per item)

`POST /v1/sim-suites/{suite_id}/runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-08-12** `5a5597ebb2d6` — 30 info

## Changes

- **2026-08-12** `5a5597ebb2d6` — 30 info
  - added the new optional request property `budget_usd`
  - added the new optional request property `idempotency_key`
  - added the optional property `idempotency_key` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/failure_source` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/simulation_status` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/simulation_stop_reason` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/suite_attempt` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/suite_item_id` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/scenarios/items/sut_snapshot_sha256` to the response with the `201` status
  - added the optional property `release_eval_verdict/anyOf[subschema #1: ReleaseVerdict]/summary/lifecycle_failed_scenarios` to the response with the `201` status
  - added the optional property `retry_after` to the response with the `400` status
  - added the optional property `retry_after` to the response with the `401` status
  - added the optional property `retry_after` to the response with the `404` status
  - added the optional property `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `retryable` to the response with the `404` status
  - added the optional property `runs/items/agent_turn_count` to the response with the `201` status
  - added the optional property `runs/items/budget_usd` to the response with the `201` status
  - added the optional property `runs/items/heartbeat_at` to the response with the `201` status
  - added the optional property `runs/items/idempotency_key` to the response with the `201` status
  - added the optional property `runs/items/persona_turn_count` to the response with the `201` status
  - added the optional property `runs/items/spent_usd` to the response with the `201` status
  - added the optional property `runs/items/stop_reason` to the response with the `201` status
  - added the optional property `runs/items/suite_attempt` to the response with the `201` status
  - added the optional property `runs/items/suite_id` to the response with the `201` status
  - added the optional property `runs/items/suite_item_id` to the response with the `201` status
  - added the optional property `runs/items/suite_run_id` to the response with the `201` status
  - added the optional property `runs/items/sut_snapshot_sha256` to the response with the `201` status
  - added the optional property `runs/items/transcript_chars` to the response with the `201` status
  - the `schema_version` response's property default value changed from `1` to `2` for the status `201`

---

[Operation](https://skmtc.dev/oneloop-hq/apis/feather-api/docs/v1/sim-suites/:suite_id/runs/post.md) · [API](https://skmtc.dev/oneloop-hq/apis/feather-api.md) · [Page](https://skmtc.dev/oneloop-hq/apis/feather-api/changes/v1/sim-suites/:suite_id/runs/post)