---
title: "Changes to Create Task Run"
method: POST
path: "/api/task_runs/"
---

# Changes to Create Task Run

`POST /api/task_runs/`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 50 revisions.

- **2024-05-31** `bc1bced1d6c9` — 1 info
- **2024-04-03** `93ae2b3f2efd` — 16 breaking, 15 warning

## Changes

- **2024-05-31** `bc1bced1d6c9` — 1 info
  - added the new optional request property `id`
- **2024-04-03** `93ae2b3f2efd` — 16 breaking, 15 warning
  - 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 `dynamic_key` became required
  - the request property `state/allOf[subschema #1: StateCreate]/type` became required
  - the request property `task_key` 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 `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 `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`

---

[Operation](https://skmtc.dev/prefecthq/apis/untitled-api-2/docs/api/task_runs/post.md) · [API](https://skmtc.dev/prefecthq/apis/untitled-api-2.md) · [Page](https://skmtc.dev/prefecthq/apis/untitled-api-2/changes/api/task_runs/post)