---
title: "Changes to Create or update a schedule for a specified workflow with a corresponding start workflow request"
method: POST
path: "/api/scheduler/schedules"
---

# Changes to Create or update a schedule for a specified workflow with a corresponding start workflow request

`POST /api/scheduler/schedules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 6 revisions.

- **2026-10-13** `5c3aad1c75ee`: 2 info
- **2026-10-10** `a142cbe9d486`: 23 breaking, 11 warning, 7 info

## Changes

- **2026-10-13** `5c3aad1c75ee`: 2 info
  - added the new optional request property `cronSchedules`
  - the `cronExpression` request property's minLength was decreased from `1` to `0`
- **2026-10-10** `a142cbe9d486`: 23 breaking, 11 warning, 7 info
  - added the new required request property `startWorkflowRequest/workflowDef/tasks/items/onStateChange/additionalProperties/items/type`
  - the request's body type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks` request property's minItems was increased to `1`
  - the `cronExpression` request property's minLength was increased from `0` to `1`
  - the `name` request property's minLength was increased from `0` to `1`
  - the `startWorkflowRequest/workflowDef/name` request property's minLength was increased from `0` to `1`
  - the `startWorkflowRequest/workflowDef/tasks/items/name` request property's minLength was increased from `0` to `1`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/name` request property's minLength was increased from `0` to `1`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskReferenceName` request property's minLength was increased from `0` to `1`
  - added the pattern `^[\w-]*$` to the request property `name`
  - the `startWorkflowRequest` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/cacheConfig` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/inputSchema` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/outputSchema` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/rateLimitConfig` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/cacheConfig` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/onStateChange/additionalProperties/items/` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/subWorkflowParam` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/inputSchema` request property type changed from no type to `object`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/outputSchema` request property type changed from no type to `object`
  - the `startWorkflowRequest/priority` request property's max was set to `99.00`
  - the `startWorkflowRequest/workflowDef/schemaVersion` request property's max was set to `2.00`
  - the `startWorkflowRequest/priority` request property's min was set to `0.00`
  - the `startWorkflowRequest/workflowDef/schemaVersion` request property's min was set to `2.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/backoffJitterMs` request property's min was set to `0.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/backoffScaleFactor` request property's min was set to `1.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/maxRetryDelaySeconds` request property's min was set to `0.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/pollTimeoutSeconds` request property's min was set to `0.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/responseTimeoutSeconds` request property's min was set to `1.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/retryCount` request property's min was set to `0.00`
  - the `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/totalTimeoutSeconds` request property's min was set to `0.00`
  - added the new optional request property `startWorkflowRequest/workflowDef/tasks/items/onStateChange/additionalProperties/items/payload`
  - the request property `cronExpression` became optional
  - the request property `name` became optional
  - the request property `startWorkflowRequest/workflowDef/name` became optional
  - the request property `startWorkflowRequest/workflowDef/tasks/items/name` became optional
  - the request property `startWorkflowRequest/workflowDef/tasks/items/taskDefinition/name` became optional
  - …1 more

---

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