---
title: "Changes to Create a run"
method: POST
path: "/v0/run"
---

# Changes to Create a run

`POST /v0/run`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 39 of 194 revisions.

- **2026-10-22** `fa0ddcf7e9f7`: 1 info
- **2026-10-17** `4187623dc587`: 2 warning, 2 info
- **2026-10-11** `edcaa65c5a0b`: 1 info
- **2026-10-11** `a283b6bd330a`: 1 info
- **2026-10-03** `e3e960221087`: 1 info
- **2026-10-03** `19d23240fdca`: 2 breaking
- **2026-09-28** `54cbf98ea77b`: 1 info
- **2026-09-23** `6b8d0bafd2dd`: 5 breaking, 2 warning, 8 info
- **2026-09-19** `4e91e95f3d45`: 1 info
- **2026-09-18** `2ca549d2a218`: 1 breaking, 1 info
- **2026-09-14** `132b74d3c048`: 1 info
- **2026-09-13** `bd9feb3fdf4b`: 1 info
- **2026-08-24** `74e9728a444e`: 1 breaking, 3 info
- **2026-08-23** `29197494dbb8`: 2 breaking
- **2026-08-23** `cd9fd5bf9ec4`: 1 info
- **2026-08-23** `ea153b917820`: 5 breaking, 2 warning, 3 info
- **2026-08-23** `84534ed6cb3d`: 2 warning, 2 info
- **2026-08-15** `7defb35a973c`: 2 warning, 2 info
- **2026-07-18** `7fa158f8dfcf`: 4 breaking, 1 info
- **2026-07-11** `438ed2491864`: 1 warning, 1 info
- **2026-04-01** `4b5ba6607d1e`: 1 info
- **2026-03-26** `60595b1a61f0`: 2 warning, 2 info
- **2026-03-23** `1634d744359e`: 4 info
- **2026-03-08** `a8f8ff63a321`: 1 info
- **2026-03-02** `d05ed2257464`: 1 info
- **2026-02-28** `696f9535bb8b`: 2 info
- **2026-02-26** `e6055a86dc91`: 2 info
- **2026-02-22** `b7250beffe09`: 2 info
- **2026-02-20** `34b4a8e3a4c3`: 1 info
- **2025-10-18** `7644ea697df5`: 1 breaking, 1 warning, 2 info
- **2025-08-10** `8c6d9d1c6270`: 1 breaking
- **2025-08-10** `c2d6b1d67c04`: 2 breaking
- **2025-08-10** `e1332be6f87b`: 3 breaking, 3 warning
- **2025-08-09** `857f697f66a4`: 3 breaking, 3 warning
- **2025-08-09** `2be9839636fa`: 3 breaking, 3 warning
- **2025-08-09** `ca83201e45e6`: 8 breaking
- **2025-08-08** `7b38ab3b0881`: 3 breaking, 3 warning
- **2025-03-20** `ba55104bc504`: 6 breaking, 2 info
- **2025-03-02** `5985f0c9180b`: 1 breaking, 2 warning

## Changes

- **2026-10-22** `fa0ddcf7e9f7`: 1 info
  - added the new optional request property `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/idempotency_key`
- **2026-10-17** `4187623dc587`: 2 warning, 2 info
  - added the new `shell_hyperfine_v1` enum value to the `adapter` response property for the response status `201`
  - added the new `shell_hyperfine_v2` enum value to the `adapter` response property for the response status `201`
  - added the new `shell_hyperfine_v1` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - added the new `shell_hyperfine_v2` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
- **2026-10-11** `edcaa65c5a0b`: 1 info
  - added the optional property `counts/allOf[#/components/schemas/JsonReportCounts]/results/items/lines` to the response with the `201` status
- **2026-10-11** `a283b6bd330a`: 1 info
  - added the optional property `project_key` to the response with the `201` status
- **2026-10-03** `e3e960221087`: 1 info
  - added the optional property `warnings` to the response with the `201` status
- **2026-10-03** `19d23240fdca`: 2 breaking
  - added `#/components/schemas/JsonReportThresholdModels` to the `thresholds/allOf[#/components/schemas/JsonReportThresholds]/models` request property `allOf` list
  - the `thresholds/allOf[#/components/schemas/JsonReportThresholds]/models` request property type changed from `object` to no type
- **2026-09-28** `54cbf98ea77b`: 1 info
  - added the new optional request property `job/allOf[#/components/schemas/JsonNewRunJob]/callback`
- **2026-09-23** `6b8d0bafd2dd`: 5 breaking, 2 warning, 8 info
  - the response property `alerts/items/metric` became nullable for the status `201`
  - the response property `alerts/items/metric` became optional for the status `201`
  - the `alerts/items/metric` response's property type changed from `object` to no type for status `201`
  - removed the required property `alerts/items/metric/uuid` from the response with the `201` status
  - removed the required property `alerts/items/metric/value` from the response with the `201` status
  - removed the optional property `alerts/items/metric/lower_value` from the response with the `201` status
  - removed the optional property `alerts/items/metric/upper_value` from the response with the `201` status
  - added the optional property `alerts/items/threshold/metric` to the response with the `201` status
  - added the optional property `alerts/items/threshold/parameters` to the response with the `201` status
  - added the optional property `results/items/items/measures/items/metrics/items/boundaries/items/threshold/metric` to the response with the `201` status
  - added the optional property `results/items/items/measures/items/metrics/items/boundaries/items/threshold/parameters` to the response with the `201` status
  - added the optional property `results/items/items/measures/items/threshold/allOf[#/components/schemas/JsonThresholdModel]/metric` to the response with the `201` status
  - added the optional property `results/items/items/measures/items/threshold/allOf[#/components/schemas/JsonThresholdModel]/parameters` to the response with the `201` status
  - added `#/components/schemas/JsonMetricTriple` to the `alerts/items/metric` response property `allOf` list for the response status `201`
  - added the required property `alerts/items/value` to the response with the `201` status
- **2026-09-19** `4e91e95f3d45`: 1 info
  - added the required property `alerts/items/variant` to the response with the `201` status
- **2026-09-18** `2ca549d2a218`: 1 breaking, 1 info
  - removed the required property `results/items/items/parameter` from the response with the `201` status
  - added the required property `results/items/items/variant` to the response with the `201` status
- **2026-09-14** `132b74d3c048`: 1 info
  - added the required property `project/bmf_version` to the response with the `201` status
- **2026-09-13** `bd9feb3fdf4b`: 1 info
  - added the new optional request property `bmf_version`
- **2026-08-24** `74e9728a444e`: 1 breaking, 3 info
  - removed the required property `results/items/items/parameter/allOf[#/components/schemas/JsonReportParameter]/parameters` from the response with the `201` status
  - added `#/components/schemas/JsonMetricTriple` to the `results/items/items/measures/items/metric` response property `allOf` list for the response status `201`
  - removed `#/components/schemas/JsonMetric` from the `results/items/items/measures/items/metric` response property `allOf` list for the response status `201`
  - added the required property `results/items/items/parameter/allOf[#/components/schemas/JsonReportParameter]/set` to the response with the `201` status
- **2026-08-23** `29197494dbb8`: 2 breaking
  - the response property `results/items/items/measures/items/metric` became nullable for the status `201`
  - the response property `results/items/items/measures/items/metric` became optional for the status `201`
- **2026-08-23** `cd9fd5bf9ec4`: 1 info
  - the response property `results/items/items/measures/items/metric` became required for the status `201`
- **2026-08-23** `ea153b917820`: 5 breaking, 2 warning, 3 info
  - the response property `results/items/items/measures/items/metric` became nullable for the status `201`
  - the response property `results/items/items/measures/items/metric` became optional for the status `201`
  - the `results/items/items/measures/items/metric` response's property type changed from `object` to no type for status `201`
  - removed the required property `results/items/items/measures/items/metric/uuid` from the response with the `201` status
  - removed the required property `results/items/items/measures/items/metric/value` from the response with the `201` status
  - removed the optional property `results/items/items/measures/items/metric/lower_value` from the response with the `201` status
  - removed the optional property `results/items/items/measures/items/metric/upper_value` from the response with the `201` status
  - added `#/components/schemas/JsonMetric` to the `results/items/items/measures/items/metric` response property `allOf` list for the response status `201`
  - added the required property `results/items/items/measures/items/metrics` to the response with the `201` status
  - added the required property `results/items/items/parameter` to the response with the `201` status
- **2026-08-23** `84534ed6cb3d`: 2 warning, 2 info
  - added the new `json_v0` enum value to the `adapter` response property for the response status `201`
  - added the new `json_v1` enum value to the `adapter` response property for the response status `201`
  - added the new `json_v0` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - added the new `json_v1` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
- **2026-08-15** `7defb35a973c`: 2 warning, 2 info
  - added the new `rust_gungraun_json` enum value to the `adapter` response property for the response status `201`
  - added the new `rust_gungraun_stdout` enum value to the `adapter` response property for the response status `201`
  - added the new `rust_gungraun_json` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - added the new `rust_gungraun_stdout` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
- **2026-07-18** `7fa158f8dfcf`: 4 breaking, 1 info
  - the response property `alerts` became nullable for the status `201`
  - the response property `results` became nullable for the status `201`
  - the response property `alerts` became optional for the status `201`
  - the response property `results` became optional for the status `201`
  - added the optional property `counts` to the response with the `201` status
- **2026-07-11** `438ed2491864`: 1 warning, 1 info
  - added the new `js_vitest` enum value to the `adapter` response property for the response status `201`
  - added the new `js_vitest` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
- **2026-04-01** `4b5ba6607d1e`: 1 info
  - added the new optional request property `idempotency_key`
- **2026-03-26** `60595b1a61f0`: 2 warning, 2 info
  - added the new `dart` enum value to the `adapter` response property for the response status `201`
  - added the new `dart_benchmark_harness` enum value to the `adapter` response property for the response status `201`
  - added the new `dart` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - added the new `dart_benchmark_harness` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
- **2026-03-23** `1634d744359e`: 4 info
  - added the optional property `alerts/items/threshold/testbed/spec/allOf[#/components/schemas/JsonSpec]/sandbox` to the response with the `201` status
  - added the optional property `testbed/spec/allOf[#/components/schemas/JsonSpec]/sandbox` to the response with the `201` status
  - added the required property `alerts/items/threshold/testbed/spec/allOf[#/components/schemas/JsonSpec]/os` to the response with the `201` status
  - added the required property `testbed/spec/allOf[#/components/schemas/JsonSpec]/os` to the response with the `201` status
- **2026-03-08** `a8f8ff63a321`: 1 info
  - added the new optional request property `spec_reset`
- **2026-03-02** `d05ed2257464`: 1 info
  - added the optional property `job` to the response with the `201` status
- **2026-02-28** `696f9535bb8b`: 2 info
  - added the new optional request property `job/allOf[#/components/schemas/JsonNewRunJob]/allow_failure`
  - added the new optional request property `job/allOf[#/components/schemas/JsonNewRunJob]/iter`
- **2026-02-26** `e6055a86dc91`: 2 info
  - added the optional property `alerts/items/threshold/testbed/spec/allOf[#/components/schemas/JsonSpec]/fallback` to the response with the `201` status
  - added the optional property `testbed/spec/allOf[#/components/schemas/JsonSpec]/fallback` to the response with the `201` status
- **2026-02-22** `b7250beffe09`: 2 info
  - added the optional property `alerts/items/threshold/testbed/spec` to the response with the `201` status
  - added the optional property `testbed/spec` to the response with the `201` status
- **2026-02-20** `34b4a8e3a4c3`: 1 info
  - added the new optional request property `job`
- **2025-10-18** `7644ea697df5`: 1 breaking, 1 warning, 2 info
  - removed the enum value `rust_iai_callgrind` of the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - added the new `rust_gungraun` enum value to the `adapter` response property for the response status `201`
  - added the new `rust_gungraun` enum value to the request property `settings/allOf[#/components/schemas/JsonReportSettings]/adapter/allOf[#/components/schemas/Adapter]/`
  - removed the `rust_iai_callgrind` enum value from the `adapter` response property for the response status `201`
- **2025-08-10** `8c6d9d1c6270`: 1 breaking
  - the `user/allOf[#/components/schemas/JsonPubUser]/slug` response's property type changed from `string` to no type for status `201`
- **2025-08-10** `c2d6b1d67c04`: 2 breaking
  - the `project/allOf[#/components/schemas/ResourceId]/` request property type changed from `string` to no type
  - the `project/slug` response's property type changed from `string` to no type for status `201`
- **2025-08-10** `e1332be6f87b`: 3 breaking, 3 warning
  - added `#/components/schemas/NameId` to the `branch` request property `allOf` list
  - added `#/components/schemas/NameId` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - added `#/components/schemas/NameId` to the `testbed` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_TestbedUuid_and_TestbedSlug_and_ResourceName` from the `testbed` request property `allOf` list
- **2025-08-09** `857f697f66a4`: 3 breaking, 3 warning
  - added `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `branch` request property `allOf` list
  - added `#/components/schemas/NameId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - added `#/components/schemas/NameId_for_TestbedUuid_and_TestbedSlug_and_ResourceName` to the `testbed` request property `allOf` list
  - removed `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `branch` request property `allOf` list
  - removed `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NamedId_for_TestbedUuid_and_TestbedSlug_and_ResourceName` from the `testbed` request property `allOf` list
- **2025-08-09** `2be9839636fa`: 3 breaking, 3 warning
  - added `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `branch` request property `allOf` list
  - added `#/components/schemas/NamedId_for_BranchUuid_and_BranchSlug_and_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - added `#/components/schemas/NamedId_for_TestbedUuid_and_TestbedSlug_and_ResourceName` to the `testbed` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchName` from the `branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_BranchName` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId_for_ResourceName` from the `testbed` request property `allOf` list
- **2025-08-09** `ca83201e45e6`: 8 breaking
  - the `alerts/items/benchmark/slug` response's property type changed from `string` to no type for status `201`
  - the `alerts/items/threshold/branch/slug` response's property type changed from `string` to no type for status `201`
  - the `alerts/items/threshold/measure/slug` response's property type changed from `string` to no type for status `201`
  - the `alerts/items/threshold/testbed/slug` response's property type changed from `string` to no type for status `201`
  - the `branch/slug` response's property type changed from `string` to no type for status `201`
  - the `results/items/items/benchmark/slug` response's property type changed from `string` to no type for status `201`
  - the `results/items/items/measures/items/measure/slug` response's property type changed from `string` to no type for status `201`
  - the `testbed/slug` response's property type changed from `string` to no type for status `201`
- **2025-08-08** `7b38ab3b0881`: 3 breaking, 3 warning
  - added `#/components/schemas/NameId_for_BranchName` to the `branch` request property `allOf` list
  - added `#/components/schemas/NameId_for_BranchName` to the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - added `#/components/schemas/NameId_for_ResourceName` to the `testbed` request property `allOf` list
  - removed `#/components/schemas/NameId` from the `branch` request property `allOf` list
  - removed `#/components/schemas/NameId` from the `start_point/allOf[#/components/schemas/JsonUpdateStartPoint]/branch` request property `allOf` list
  - removed `#/components/schemas/NameId` from the `testbed` request property `allOf` list
- **2025-03-20** `ba55104bc504`: 6 breaking, 2 info
  - the response property `user` became nullable for the status `201`
  - the response property `user` became optional for the status `201`
  - the `user` response's property type changed from `object` to no type for status `201`
  - removed the required property `user/name` from the response with the `201` status
  - removed the required property `user/slug` from the response with the `201` status
  - removed the required property `user/uuid` from the response with the `201` status
  - added the optional property `project/claimed` to the response with the `201` status
  - added `#/components/schemas/JsonPubUser` to the `user` response property `allOf` list for the response status `201`
- **2025-03-02** `5985f0c9180b`: 1 breaking, 2 warning
  - added `#/components/schemas/ResourceId` to the `project` request property `allOf` list
  - removed `#/components/schemas/NameId` from the `project` request property `allOf` list
  - removed the request property `organization`

---

[Operation](https://skmtc.dev/bencherdev/apis/bencher-api/docs/v0/run/post.md) - [API](https://skmtc.dev/bencherdev/apis/bencher-api.md) - [Page](https://skmtc.dev/bencherdev/apis/bencher-api/changes/v0/run/post)
