---
title: "Changes to Create or update workflow definition(s)"
method: PUT
path: "/api/metadata/workflow"
---

# Changes to Create or update workflow definition(s)

`PUT /api/metadata/workflow`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-10-10** `a142cbe9d486`: 19 breaking, 9 warning, 5 info

## Changes

- **2026-10-10** `a142cbe9d486`: 19 breaking, 9 warning, 5 info
  - added the new required request property `items/tasks/items/onStateChange/additionalProperties/items/type`
  - the `items/tasks` request property's minItems was increased to `1`
  - the `items/name` request property's minLength was increased from `0` to `1`
  - the `items/tasks/items/name` request property's minLength was increased from `0` to `1`
  - the `items/tasks/items/taskDefinition/name` request property's minLength was increased from `0` to `1`
  - the `items/tasks/items/taskReferenceName` request property's minLength was increased from `0` to `1`
  - the `items/` request property type changed from no type to `object`
  - the `items/cacheConfig` request property type changed from no type to `object`
  - the `items/inputSchema` request property type changed from no type to `object`
  - the `items/outputSchema` request property type changed from no type to `object`
  - the `items/rateLimitConfig` request property type changed from no type to `object`
  - the `items/tags/items/` request property type changed from no type to `object`
  - the `items/tasks/items/` request property type changed from no type to `object`
  - the `items/tasks/items/cacheConfig` request property type changed from no type to `object`
  - the `items/tasks/items/onStateChange/additionalProperties/items/` request property type changed from no type to `object`
  - the `items/tasks/items/subWorkflowParam` request property type changed from no type to `object`
  - the `items/tasks/items/taskDefinition` request property type changed from no type to `object`
  - the `items/tasks/items/taskDefinition/inputSchema` request property type changed from no type to `object`
  - the `items/tasks/items/taskDefinition/outputSchema` request property type changed from no type to `object`
  - the `items/schemaVersion` request property's max was set to `2.00`
  - the `items/schemaVersion` request property's min was set to `2.00`
  - the `items/tasks/items/taskDefinition/backoffJitterMs` request property's min was set to `0.00`
  - the `items/tasks/items/taskDefinition/backoffScaleFactor` request property's min was set to `1.00`
  - the `items/tasks/items/taskDefinition/maxRetryDelaySeconds` request property's min was set to `0.00`
  - the `items/tasks/items/taskDefinition/pollTimeoutSeconds` request property's min was set to `0.00`
  - the `items/tasks/items/taskDefinition/responseTimeoutSeconds` request property's min was set to `1.00`
  - the `items/tasks/items/taskDefinition/retryCount` request property's min was set to `0.00`
  - the `items/tasks/items/taskDefinition/totalTimeoutSeconds` request property's min was set to `0.00`
  - added the new optional request property `items/tasks/items/onStateChange/additionalProperties/items/payload`
  - the request property `items/name` became optional
  - the request property `items/tasks/items/name` became optional
  - the request property `items/tasks/items/taskDefinition/name` became optional
  - the request property `items/tasks/items/taskReferenceName` became optional

---

[Operation](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/docs/api/metadata/workflow/put.md) - [API](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server.md) - [Page](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/changes/api/metadata/workflow/put)