---
title: "Changes to Create Flow Run"
method: POST
path: "/api/flow_runs/"
---

# Changes to Create Flow Run

`POST /api/flow_runs/`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2025-01-16** `29ba6c4f8837`: 2 info
- **2024-04-09** `0803f67b017b`: 1 info
- **2024-04-03** `93ae2b3f2efd`: 17 breaking, 21 warning
- **2024-03-28** `f5252435d157`: 1 info
- **2024-03-13** `5c88f8c50986`: 1 warning
- **2024-03-11** `5ea7df68007c`: 2 info

## Changes

- **2025-01-16** `29ba6c4f8837`: 2 info
  - added the new optional request property `empirical_policy/allOf[subschema #1: FlowRunPolicy]/retry_type`
  - added the optional property `empirical_policy/retry_type` to the response with the `200` status
- **2024-04-09** `0803f67b017b`: 1 info
  - added the optional property `deployment_version` to the response with the `200` status
- **2024-04-03** `93ae2b3f2efd`: 17 breaking, 21 warning
  - added `#/components/schemas/FlowRunPolicy` to the `empirical_policy` request property `allOf` list
  - added `#/components/schemas/StateDetails` to the `state/allOf[subschema #1: StateCreate]/state_details` request property `allOf` list
  - added `#/components/schemas/StateType` to the `state/allOf[subschema #1: StateCreate]/type` request property `allOf` list
  - the request property `flow_id` became required
  - the request property `state/allOf[subschema #1: StateCreate]/type` became required
  - removed the enum value `CANCELLED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `CANCELLING` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `COMPLETED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `CRASHED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `FAILED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `PAUSED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `PENDING` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `RUNNING` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - removed the enum value `SCHEDULED` of the request property `state/allOf[subschema #1: StateCreate]/type`
  - the `empirical_policy` request property type changed from `object` to no type
  - the `state/allOf[subschema #1: StateCreate]/state_details` request property type changed from `object` to no type
  - the `state/allOf[subschema #1: StateCreate]/type` request property type changed from `string` to no type
  - removed the request property `empirical_policy/max_retries`
  - removed the request property `empirical_policy/pause_keys`
  - removed the request property `empirical_policy/resuming`
  - removed the request property `empirical_policy/retries`
  - removed the request property `empirical_policy/retry_delay`
  - removed the request property `empirical_policy/retry_delay_seconds`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/cache_expiration`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/cache_key`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/child_flow_run_id`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/flow_run_id`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/pause_key`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/pause_reschedule`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/pause_timeout`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/refresh_cache`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/retriable`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/run_input_keyset`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/scheduled_time`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/task_parameters_id`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/task_run_id`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/transition_id`
  - removed the request property `state/allOf[subschema #1: StateCreate]/state_details/untrackable_result`
- **2024-03-28** `f5252435d157`: 1 info
  - the response property `flow_id` became required for the status `200`
- **2024-03-13** `5c88f8c50986`: 1 warning
  - removed the request property `job_variables`
- **2024-03-11** `5ea7df68007c`: 2 info
  - added the new optional request property `job_variables`
  - added the optional property `job_variables` to the response with the `200` status

---

[Operation](https://skmtc.dev/prefecthq/apis/prefect-unreleased-api/docs/api/flow_runs/post.md) - [API](https://skmtc.dev/prefecthq/apis/prefect-unreleased-api.md) - [Page](https://skmtc.dev/prefecthq/apis/prefect-unreleased-api/changes/api/flow_runs/post)