--- title: "Changes to Create Run" method: POST path: "/api/v1/runs" --- # Changes to Create Run `POST /api/v1/runs` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 28 of 134 revisions. - **2026-08-26** `13262755c97f` — 1 info - **2026-08-26** `e7fd6d853204` — 2 info - **2026-08-25** `9abd94e6cfbe` — 2 info - **2026-08-24** `5290add6d36f` — 1 breaking, 1 info - **2026-08-23** `cfd12cf45afb` — 6 info - **2026-08-21** `6ed5f1557b9b` — 1 breaking, 10 warning, 5 info - **2026-08-04** `bee030053823` — 4 warning - **2026-08-04** `359433692f06` — 2 breaking, 2 info - **2026-08-03** `3a47e2b7312f` — 1 warning - **2026-08-03** `d0531013c74c` — 2 warning - **2026-08-01** `4f967e63aefb` — 1 warning - **2026-08-01** `c000383bccf4` — 1 warning - **2026-08-01** `16225918a5c8` — 1 info - **2026-08-01** `d6eb49d55d5c` — 1 warning - **2026-07-28** `ef906071a8e4` — 1 warning, 2 info - **2026-07-28** `7fe7b6755799` — 2 breaking, 1 info - **2026-07-28** `4f9aedeb7211` — 1 warning, 2 info - **2026-07-28** `d043ecc9a652` — 2 breaking - **2026-07-28** `fa4de608a93c` — 2 info - **2026-07-27** `44617fd2c722` — 1 info - **2026-07-27** `ad4eeab2bd6f` — 1 warning - **2026-06-13** `de85d0556040` — 1 breaking, 2 info - **2026-05-27** `1fa851815cf2` — 4 breaking, 4 info - **2026-05-27** `682a04780c6e` — 1 info - **2026-05-23** `f0039c82fe7f` — 1 breaking, 1 warning, 4 info - **2026-05-23** `687e515d2bde` — 1 info - **2026-05-23** `75eb02b1c66b` — 1 info - **2026-05-23** `41937812f640` — 1 warning, 1 info ## Changes - **2026-08-26** `13262755c97f` — 1 info - added the new optional request property `oneOf[#/components/schemas/RunIntent]/target/oneOf[#/components/schemas/GitRunTarget]/tag` - **2026-08-26** `e7fd6d853204` — 2 info - added `folder` discriminator mapping keys to the `oneOf[#/components/schemas/RunIntent]/target` request property - added `#/components/schemas/FolderRunTarget` to the `oneOf[#/components/schemas/RunIntent]/target` request property `oneOf` list - **2026-08-25** `9abd94e6cfbe` — 2 info - added `none` discriminator mapping keys to the `oneOf[#/components/schemas/RunIntent]/target` request property - added `#/components/schemas/NoneRunTarget` to the `oneOf[#/components/schemas/RunIntent]/target` request property `oneOf` list - **2026-08-24** `5290add6d36f` — 1 breaking, 1 info - removed `#/components/schemas/NoneRunTarget` from the `oneOf[#/components/schemas/RunIntent]/target` request property `oneOf` list - removed `none` discriminator mapping keys from the `oneOf[#/components/schemas/RunIntent]/target` request property - **2026-08-23** `cfd12cf45afb` — 6 info - added `none` discriminator mapping keys to the `oneOf[#/components/schemas/RunIntent]/target` request property - added `#/components/schemas/NoneRunTarget` to the `oneOf[#/components/schemas/RunIntent]/target` request property `oneOf` list - removed the non-success response with the status `404` - removed the non-success response with the status `422` - removed the non-success response with the status `500` - removed the non-success response with the status `503` - **2026-08-21** `6ed5f1557b9b` — 1 breaking, 10 warning, 5 info - the request's body type/format changed from `object`/`` to ``/`` - removed the request property `args` - removed the request property `configs` - removed the request property `cwd` - removed the request property `git` - removed the request property `goal` - removed the request property `parent_id` - removed the request property `target` - removed the request property `title` - removed the request property `version` - removed the request property `workflows` - added `#/components/schemas/RunManifest, #/components/schemas/RunIntent` to the request body `oneOf` list - added the non-success response with the status `404` - added the non-success response with the status `422` - added the non-success response with the status `500` - added the non-success response with the status `503` - **2026-08-04** `bee030053823` — 4 warning - removed the request property `git/push_outcome` - removed the request property `goal/path` - removed the request property `run_id` - removed the request property `target/identifier` - **2026-08-04** `359433692f06` — 2 breaking, 2 info - added the new required request property `git/push_outcome` - added the new required request property `target/identifier` - added the new optional request property `goal/path` - added the new optional request property `run_id` - **2026-08-03** `3a47e2b7312f` — 1 warning - removed the request property `git/push_outcome` - **2026-08-03** `d0531013c74c` — 2 warning - removed the request property `goal/path` - removed the request property `target/identifier` - **2026-08-01** `4f967e63aefb` — 1 warning - removed the request property `run_id` - **2026-08-01** `c000383bccf4` — 1 warning - removed the request property `args/docker_image` - **2026-08-01** `16225918a5c8` — 1 info - added the new optional request property `args/docker_image` - **2026-08-01** `d6eb49d55d5c` — 1 warning - removed the request property `args/docker_image` - **2026-07-28** `ef906071a8e4` — 1 warning, 2 info - added the new `publish_failed` enum value to the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/inference_time_ms` became required for the status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/tool_time_ms` became required for the status `201` - **2026-07-28** `7fe7b6755799` — 2 breaking, 1 info - the response property `timing/oneOf[#/components/schemas/RunTiming]/inference_time_ms` became optional for the status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/tool_time_ms` became optional for the status `201` - removed the `publish_failed` enum value from the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - **2026-07-28** `4f9aedeb7211` — 1 warning, 2 info - added the new `publish_failed` enum value to the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/inference_time_ms` became required for the status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/tool_time_ms` became required for the status `201` - **2026-07-28** `d043ecc9a652` — 2 breaking - the response property `timing/oneOf[#/components/schemas/RunTiming]/inference_time_ms` became optional for the status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/tool_time_ms` became optional for the status `201` - **2026-07-28** `fa4de608a93c` — 2 info - the response property `timing/oneOf[#/components/schemas/RunTiming]/inference_time_ms` became required for the status `201` - the response property `timing/oneOf[#/components/schemas/RunTiming]/tool_time_ms` became required for the status `201` - **2026-07-27** `44617fd2c722` — 1 info - removed the `publish_failed` enum value from the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - **2026-07-27** `ad4eeab2bd6f` — 1 warning - added the new `publish_failed` enum value to the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - **2026-06-13** `de85d0556040` — 1 breaking, 2 info - added `#/components/schemas/PrincipalUser, #/components/schemas/PrincipalWorker, #/components/schemas/PrincipalWebhook, #/components/schemas/PrincipalSlack, #/components/schemas/PrincipalAgent, #/components/schemas/PrincipalSystem` to the `created_by` response property `oneOf` list for the response status `201` - added discriminator to `created_by` response property for the response status `201` - removed `#/components/schemas/Principal, subschema #2` from the `created_by` response property `oneOf` list for the response status `201` - **2026-05-27** `1fa851815cf2` — 4 breaking, 4 info - removed the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/image` from the response with the `201` status - removed the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/provider` from the response with the `201` status - removed the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/runtime` from the response with the `201` status - removed the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/snapshot` from the response with the `201` status - added the optional property `sandbox/oneOf[#/components/schemas/RunSandbox]/failure` to the response with the `201` status - added the optional property `sandbox/oneOf[#/components/schemas/RunSandbox]/instance` to the response with the `201` status - added the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/kind` to the response with the `201` status - added the required property `sandbox/oneOf[#/components/schemas/RunSandbox]/plan` to the response with the `201` status - **2026-05-27** `682a04780c6e` — 1 info - added the optional property `automation/oneOf[#/components/schemas/AutomationRef]/trigger_id` to the response with the `201` status - **2026-05-23** `f0039c82fe7f` — 1 breaking, 1 warning, 4 info - added `#/components/schemas/RunStatusPending, #/components/schemas/RunStatusRunnable` to the `lifecycle/status` response property `oneOf` list for the response status `201` - added the new `approval_denied` enum value to the `lifecycle/status/oneOf[#/components/schemas/RunStatusFailed]/reason` response property for the response status `201` - added `pending, runnable` discriminator mapping keys to the `lifecycle/status` response property for the response status `201` - removed `queued` discriminator mapping keys from the `lifecycle/status` response property for the response status `201` - removed `#/components/schemas/RunStatusQueued` from the `lifecycle/status` response property `oneOf` list for the response status `201` - added the required property `lifecycle/approval` to the response with the `201` status - **2026-05-23** `687e515d2bde` — 1 info - added the required property `size` to the response with the `201` status - **2026-05-23** `75eb02b1c66b` — 1 info - added the required property `retried_from` to the response with the `201` status - **2026-05-23** `41937812f640` — 1 warning, 1 info - removed the request property `args/sandbox` - added the new optional request property `args/environment` --- [Operation](https://skmtc.dev/fabro-sh/apis/fabro-run-api/docs/api/v1/runs/post.md) · [API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [Page](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/runs/post)