---
title: "Changes to Execute a workflow synchronously"
method: POST
path: "/api/workflow/execute/{name}/{version}"
---

# Changes to Execute a workflow synchronously

`POST /api/workflow/execute/{name}/{version}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 6 revisions.

- **2026-10-10** `a142cbe9d486`: 21 breaking, 12 warning, 8 info

## Changes

- **2026-10-10** `a142cbe9d486`: 21 breaking, 12 warning, 8 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`
  - added `#/components/schemas/WorkflowRun, #/components/schemas/TaskRun` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from no type to `object` for status `200`
  - 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 `BLOCKING_TASK_LIST` enum value to the `responseType` response property for the response status `200`
  - added the new optional request property `workflowDef/tasks/items/onStateChange/additionalProperties/items/payload`
  - added the new enum value `BLOCKING_TASK_LIST` to the `query` request parameter `returnStrategy`
  - 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
  - added response discriminator for the response status `200`
  - …1 more

---

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