---
title: "Changes to Dispatch a simulation run"
method: POST
path: "/v1/simulation/runs"
---

# Changes to Dispatch a simulation run

`POST /v1/simulation/runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-08-12** `5a5597ebb2d6`: 19 info

## Changes

- **2026-08-12** `5a5597ebb2d6`: 19 info
  - added the new optional request property `budget_usd`
  - added the new optional request property `idempotency_key`
  - added the optional property `agent_turn_count` to the response with the `201` status
  - added the optional property `budget_usd` to the response with the `201` status
  - added the optional property `heartbeat_at` to the response with the `201` status
  - added the optional property `idempotency_key` to the response with the `201` status
  - added the optional property `persona_turn_count` 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 `retryable` to the response with the `400` status
  - added the optional property `retryable` to the response with the `401` status
  - added the optional property `spent_usd` to the response with the `201` status
  - added the optional property `stop_reason` to the response with the `201` status
  - added the optional property `suite_attempt` to the response with the `201` status
  - added the optional property `suite_id` to the response with the `201` status
  - added the optional property `suite_item_id` to the response with the `201` status
  - added the optional property `suite_run_id` to the response with the `201` status
  - added the optional property `sut_snapshot_sha256` to the response with the `201` status
  - added the optional property `transcript_chars` to the response with the `201` status

---

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