---
title: "Changes to Update a task"
method: POST
path: "/api/tasks/update-v2"
---

# Changes to Update a task

`POST /api/tasks/update-v2`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-10-10** `a142cbe9d486`: 10 breaking, 4 info

## Changes

- **2026-10-10** `a142cbe9d486`: 10 breaking, 4 info
  - the request's body type changed from no type to `object`
  - the `taskId` request property's minLength was increased from `0` to `1`
  - the `workflowInstanceId` request property's minLength was increased from `0` to `1`
  - the `executionMetadata` request property type changed from no type to `object`
  - the `logs/items/` request property type changed from no type to `object`
  - the `orCreateExecutionMetadata` request property type changed from no type to `object`
  - the response property `taskDefinition/name` became optional for the status `200`
  - the response property `workflowTask/name` became optional for the status `200`
  - the response property `workflowTask/taskDefinition/name` became optional for the status `200`
  - the response property `workflowTask/taskReferenceName` became optional for the status `200`
  - the request property `taskId` became optional
  - the request property `workflowInstanceId` became optional
  - added the optional property `workflowTask/onStateChange/additionalProperties/items/payload` to the response with the `200` status
  - added the required property `workflowTask/onStateChange/additionalProperties/items/type` to the response with the `200` status

---

[Operation](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/docs/api/tasks/update-v2/post.md) - [API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) - [Page](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/changes/api/tasks/update-v2/post)
