---
title: "Changes to Create Task Run"
method: POST
path: "/v1/tasks/runs"
---

# Changes to Create Task Run

`POST /v1/tasks/runs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 26 revisions.

- **2026-10-16** `fc4858951ccf`: 1 info
- **2026-08-10** `8dc682666146`: 1 info
- **2026-04-21** `57e1c56be094`: 7 info
- **2026-03-09** `970b780e8649`: 2 info
- **2026-01-13** `105d778ad64d`: 10 breaking, 26 info
- **2025-11-06** `a2d634b57a8e`: 2 info
- **2025-09-15** `ed59cb6466c0`: 4 info
- **2025-08-31** `1aeb1c81a849`: 1 breaking, 3 warning, 15 info
- **2025-08-31** `ff0d5939e135`: 5 breaking, 3 warning, 11 info
- **2025-08-31** `1aeb1c81a849`: 1 breaking, 3 warning, 15 info
- **2025-04-25** `ff0d5939e135`: 2 breaking

## Changes

- **2026-10-16** `fc4858951ccf`: 1 info
  - added the new optional request property `advanced_settings/anyOf[subschema #1: TaskAdvancedSettings]/data_sources`
- **2026-08-10** `8dc682666146`: 1 info
  - added the new optional request property `memory_scope_key`
- **2026-04-21** `57e1c56be094`: 7 info
  - api tag `Tasks` added
  - api tag `Tasks v1` removed
  - added the new optional `header` request parameter `parallel-beta`
  - added the new optional request property `advanced_settings`
  - added the new optional request property `enable_events`
  - added the new optional request property `mcp_servers`
  - added the new optional request property `webhook`
- **2026-03-09** `970b780e8649`: 2 info
  - added the new optional request property `previous_interaction_id`
  - added the required property `interaction_id` to the response with the `202` status
- **2026-01-13** `105d778ad64d`: 10 breaking, 26 info
  - removed the enum value `auto` of the request property `task_spec/anyOf[subschema #1: TaskSpec]/output_schema/anyOf[subschema #3: AutoSchema]/type`
  - removed the enum value `json` of the request property `task_spec/anyOf[subschema #1: TaskSpec]/input_schema/anyOf[subschema #2: JsonSchema]/type`
  - removed the enum value `json` of the request property `task_spec/anyOf[subschema #1: TaskSpec]/output_schema/anyOf[subschema #1: JsonSchema]/type`
  - removed the enum value `text` of the request property `task_spec/anyOf[subschema #1: TaskSpec]/input_schema/anyOf[subschema #3: TextSchema]/type`
  - removed the enum value `text` of the request property `task_spec/anyOf[subschema #1: TaskSpec]/output_schema/anyOf[subschema #2: TextSchema]/type`
  - the `error` response's property type changed from no type to `object` for status `401`
  - the `error` response's property type changed from no type to `object` for status `402`
  - the `error` response's property type changed from no type to `object` for status `403`
  - the `error` response's property type changed from no type to `object` for status `422`
  - the `error` response's property type changed from no type to `object` for status `429`
  - added the new optional request property `source_policy/anyOf[subschema #1: SourcePolicy]/after_date`
  - added the optional property `error/detail` to the response with the `401` status
  - added the optional property `error/detail` to the response with the `402` status
  - added the optional property `error/detail` to the response with the `403` status
  - added the optional property `error/detail` to the response with the `422` status
  - added the optional property `error/detail` to the response with the `429` status
  - removed `#/components/schemas/Error` from the `error` response property `allOf` list for the response status `401`
  - removed `#/components/schemas/Error` from the `error` response property `allOf` list for the response status `402`
  - removed `#/components/schemas/Error` from the `error` response property `allOf` list for the response status `403`
  - removed `#/components/schemas/Error` from the `error` response property `allOf` list for the response status `422`
  - removed `#/components/schemas/Error` from the `error` response property `allOf` list for the response status `429`
  - removed the `error` enum value from the `type` response property for the response status `401`
  - removed the `error` enum value from the `type` response property for the response status `402`
  - removed the `error` enum value from the `type` response property for the response status `403`
  - removed the `error` enum value from the `type` response property for the response status `422`
  - removed the `error` enum value from the `type` response property for the response status `429`
  - added the required property `error/message` to the response with the `401` status
  - added the required property `error/message` to the response with the `402` status
  - added the required property `error/message` to the response with the `403` status
  - added the required property `error/message` to the response with the `422` status
  - added the required property `error/message` to the response with the `429` status
  - added the required property `error/ref_id` to the response with the `401` status
  - added the required property `error/ref_id` to the response with the `402` status
  - added the required property `error/ref_id` to the response with the `403` status
  - added the required property `error/ref_id` to the response with the `422` status
  - added the required property `error/ref_id` to the response with the `429` status
- **2025-11-06** `a2d634b57a8e`: 2 info
  - api tag `Tasks v1` added
  - api tag `Task API v1` removed
- **2025-09-15** `ed59cb6466c0`: 4 info
  - the request property `task_spec/anyOf[subschema #1: TaskSpec]/input_schema/anyOf[subschema #3: TextSchema]/description` became optional
  - the request property `task_spec/anyOf[subschema #1: TaskSpec]/output_schema/anyOf[subschema #2: TextSchema]/description` became optional
  - request property `task_spec/anyOf[subschema #1: TaskSpec]/input_schema/anyOf[subschema #3: TextSchema]/description` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `task_spec/anyOf[subschema #1: TaskSpec]/output_schema/anyOf[subschema #2: TextSchema]/description` list-of-types was widened by adding types `null` to media type `application/json`
- **2025-08-31** `1aeb1c81a849`: 1 breaking, 3 warning, 15 info
  - removed the success response with the status `200`
  - added the new `input_validation_warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - added the new `spec_validation_warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - added the new `warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - api tag `Task API v1` added
  - api tag `v1` removed
  - added the new optional request property `source_policy`
  - added `#/components/schemas/AutoSchema` to the `task_spec/anyOf[subschema #1: TaskSpec]/output_schema` request property `anyOf` list
  - added the non-success response with the status `401`
  - added the optional property `error` to the response with the `202` status
  - added the optional property `taskgroup_id` to the response with the `202` status
  - the response property `type` became required for the status `402`
  - the response property `type` became required for the status `403`
  - the response property `type` became required for the status `422`
  - the response property `type` became required for the status `429`
  - the `type` response's property default value `error` was removed for the status `402`
  - the `type` response's property default value `error` was removed for the status `403`
  - the `type` response's property default value `error` was removed for the status `422`
  - the `type` response's property default value `error` was removed for the status `429`
- **2025-08-31** `ff0d5939e135`: 5 breaking, 3 warning, 11 info
  - removed `#/components/schemas/AutoSchema` from the `task_spec/anyOf[subschema #1: TaskSpec]/output_schema` request property `anyOf` list
  - the response property `type` became optional for the status `402`
  - the response property `type` became optional for the status `403`
  - the response property `type` became optional for the status `422`
  - the response property `type` became optional for the status `429`
  - removed the request property `source_policy`
  - removed the optional property `error` from the response with the `202` status
  - removed the optional property `taskgroup_id` from the response with the `202` status
  - api tag `v1` added
  - api tag `Task API v1` removed
  - removed the non-success response with the status `401`
  - the `type` response's property default value `error` was added for the status `402`
  - the `type` response's property default value `error` was added for the status `403`
  - the `type` response's property default value `error` was added for the status `422`
  - the `type` response's property default value `error` was added for the status `429`
  - removed the `input_validation_warning` enum value from the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - removed the `spec_validation_warning` enum value from the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - removed the `warning` enum value from the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - added the success response with the status `200`
- **2025-08-31** `1aeb1c81a849`: 1 breaking, 3 warning, 15 info
  - removed the success response with the status `200`
  - added the new `input_validation_warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - added the new `spec_validation_warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - added the new `warning` enum value to the `warnings/anyOf[subschema #1]/items/type` response property for the response status `202`
  - api tag `Task API v1` added
  - api tag `v1` removed
  - added the new optional request property `source_policy`
  - added `#/components/schemas/AutoSchema` to the `task_spec/anyOf[subschema #1: TaskSpec]/output_schema` request property `anyOf` list
  - added the non-success response with the status `401`
  - added the optional property `error` to the response with the `202` status
  - added the optional property `taskgroup_id` to the response with the `202` status
  - the response property `type` became required for the status `402`
  - the response property `type` became required for the status `403`
  - the response property `type` became required for the status `422`
  - the response property `type` became required for the status `429`
  - the `type` response's property default value `error` was removed for the status `402`
  - the `type` response's property default value `error` was removed for the status `403`
  - the `type` response's property default value `error` was removed for the status `422`
  - the `type` response's property default value `error` was removed for the status `429`
- **2025-04-25** `ff0d5939e135`: 2 breaking
  - removed the required property `message` from the response with the `200` status
  - removed the required property `message` from the response with the `202` status

---

[Operation](https://skmtc.dev/parallel-web/apis/parallel-api/docs/v1/tasks/runs/post.md) - [API](https://skmtc.dev/parallel-web/apis/parallel-api.md) - [Page](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1/tasks/runs/post)
