---
title: "Changes to Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain"
method: POST
path: "/api/workflow"
---

# Changes to Start a new workflow with StartWorkflowRequest, which allows task to be executed in a domain

`POST /api/workflow`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

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

## Changes

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

---

[Operation](https://skmtc.dev/orkescloud/apis/orkes-conductor-api-server/docs/api/workflow/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/workflow/post)