---
title: "Changes to Create Flow Run From Deployment"
method: POST
path: "/api/deployments/{id}/create_flow_run"
---

# Changes to Create Flow Run From Deployment

`POST /api/deployments/{id}/create_flow_run`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2025-01-16** `29ba6c4f8837` — 2 info
- **2024-08-30** `67400ee9e9bd` — 1 info
- **2024-04-09** `0803f67b017b` — 1 info
- **2024-04-03** `93ae2b3f2efd` — 16 breaking, 21 warning
- **2024-03-28** `f5252435d157` — 1 info
- **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-08-30** `67400ee9e9bd` — 1 info
  - added the new optional request property `enforce_parameter_schema`
- **2024-04-09** `0803f67b017b` — 1 info
  - added the optional property `deployment_version` to the response with the `200` status
- **2024-04-03** `93ae2b3f2efd` — 16 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 `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/format changed from `object`/`` to ``/``
  - the `state/allOf[subschema #1: StateCreate]/state_details` request property type/format changed from `object`/`` to ``/``
  - the `state/allOf[subschema #1: StateCreate]/type` request property type/format changed from `string`/`` to ``/``
  - 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-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/untitled-api-2/docs/api/deployments/:id/create_flow_run/post.md) · [API](https://skmtc.dev/prefecthq/apis/untitled-api-2.md) · [Page](https://skmtc.dev/prefecthq/apis/untitled-api-2/changes/api/deployments/:id/create_flow_run/post)