---
title: "Changes to start a workflow"
method: POST
path: "/api/v1/workflow/start"
---

# Changes to start a workflow

`POST /api/v1/workflow/start`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 34 of 69 revisions.

- **2026-07-17** `fe9c7606824c`: 11 info
- **2025-02-04** `f214e9d70d66`: 1 info
- **2024-10-30** `377ec9ef7ac8`: 1 info
- **2024-10-24** `6be3be10876f`: 1 warning, 1 info
- **2024-10-17** `d4cb0840ac8b`: 4 info
- **2024-09-30** `529343079251`: 1 info
- **2024-09-25** `b80e3bf56893`: 1 info
- **2024-07-26** `290e92306fc3`: 1 info
- **2024-05-14** `90548a4540ab`: 8 info
- **2024-03-21** `dab21511e828`: 1 info
- **2023-09-18** `be60cc6beab2`: 1 info
- **2023-08-23** `ec9487539a06`: 3 info
- **2023-08-05** `3944ca03b15a`: 1 warning, 3 info
- **2023-07-05** `b341064dfc4b`: 1 warning
- **2023-05-31** `ca16607cb0f3`: 1 info
- **2023-05-08** `13cdae04937f`: 6 info
- **2023-04-15** `86630172940f`: 1 warning, 4 info
- **2023-04-13** `59dba7993ef7`: 2 info
- **2023-04-12** `f5d62c720c7a`: 6 info
- **2023-04-11** `2691858c0c3a`: 1 info
- **2023-04-07** `d772e30a1e53`: 1 warning, 1 info
- **2023-04-04** `f426bfa244bf`: 1 info
- **2023-03-30** `1ca160d62ae5`: 1 info
- **2023-03-02** `d9e8179f01ca`: 2 info
- **2023-02-27** `8342a6880406`: 1 info
- **2023-02-03** `46e573464592`: 3 breaking
- **2023-01-12** `f7d20041860e`: 3 warning
- **2022-12-27** `5a146368b6cd`: 1 info
- **2022-12-18** `a325ec23e79c`: 2 info
- **2022-12-16** `9248feaa5185`: 6 warning, 8 info
- **2022-12-11** `84d183ca720b`: 3 warning, 6 info
- **2022-11-15** `32141aefeb34`: 1 info
- **2022-10-26** `76b52de3323a`: 7 breaking
- **2022-10-09** `0dfb1207bf6c`: 1 breaking

## Changes

- **2026-07-17** `fe9c7606824c`: 11 info
  - added the new optional request property `stateInput/extPath`
  - added the new optional request property `stateInput/extStoreId`
  - added the new optional request property `stateOptions/dataAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/dataObjectsLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/executeApiDataAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/executeApiSearchAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/searchAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/waitUntilApiDataAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `stateOptions/waitUntilApiSearchAttributesLoadingPolicy/lazyLoadingLargeDataAttributes`
  - added the new optional request property `workflowStartOptions/dataAttributes/items/value/extPath`
  - added the new optional request property `workflowStartOptions/dataAttributes/items/value/extStoreId`
- **2025-02-04** `f214e9d70d66`: 1 info
  - added the new optional request property `workflowStartOptions/workflowConfigOverride/optimizeTimer`
- **2024-10-30** `377ec9ef7ac8`: 1 info
  - added the new optional request property `workflowStartOptions/workflowAlreadyStartedOptions`
- **2024-10-24** `6be3be10876f`: 1 warning, 1 info
  - removed the request property `workflowStartOptions/workflowConfigOverride/enabledExecutingStateExecutionIds`
  - added the new optional request property `workflowStartOptions/workflowConfigOverride/executingStateIdMode`
- **2024-10-17** `d4cb0840ac8b`: 4 info
  - added the new optional request property `stateOptions/executeApiDataAttributesLoadingPolicy`
  - added the new optional request property `stateOptions/executeApiSearchAttributesLoadingPolicy`
  - added the new optional request property `stateOptions/waitUntilApiDataAttributesLoadingPolicy`
  - added the new optional request property `stateOptions/waitUntilApiSearchAttributesLoadingPolicy`
- **2024-09-30** `529343079251`: 1 info
  - added the new optional request property `workflowStartOptions/dataAttributes`
- **2024-09-25** `b80e3bf56893`: 1 info
  - added the new `ALLOW_IF_PREVIOUS_EXITS_ABNORMALLY` enum value to the request property `workflowStartOptions/idReusePolicy`
- **2024-07-26** `290e92306fc3`: 1 info
  - added the new optional request property `waitForCompletionStateIds`
- **2024-05-14** `90548a4540ab`: 8 info
  - added the new optional request property `stateOptions/dataAttributesLoadingPolicy/useKeyAsPrefix`
  - added the new optional request property `stateOptions/dataObjectsLoadingPolicy/useKeyAsPrefix`
  - added the new optional request property `stateOptions/searchAttributesLoadingPolicy/useKeyAsPrefix`
  - added the new optional request property `workflowStartOptions/workflowConfigOverride/enabledExecutingStateExecutionIds`
  - added the new optional request property `workflowStartOptions/workflowConfigOverride/optimizeActivity`
  - added the new `LOAD_ALL_WITH_PARTIAL_LOCK` enum value to the request property `stateOptions/dataAttributesLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_ALL_WITH_PARTIAL_LOCK` enum value to the request property `stateOptions/dataObjectsLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_ALL_WITH_PARTIAL_LOCK` enum value to the request property `stateOptions/searchAttributesLoadingPolicy/persistenceLoadingType`
- **2024-03-21** `dab21511e828`: 1 info
  - added the new optional request property `workflowStartOptions/workflowStartDelaySeconds`
- **2023-09-18** `be60cc6beab2`: 1 info
  - added the new optional request property `waitForCompletionStateExecutionIds`
- **2023-08-23** `ec9487539a06`: 3 info
  - added the new optional request property `stateOptions/executeApiFailurePolicy`
  - added the new optional request property `stateOptions/executeApiFailureProceedStateId`
  - added the new optional request property `stateOptions/executeApiFailureProceedStateOptions`
- **2023-08-05** `3944ca03b15a`: 1 warning, 3 info
  - removed the request property `stateOptions/commandCarryOverPolicy`
  - added the new `LOAD_NONE` enum value to the request property `stateOptions/dataAttributesLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_NONE` enum value to the request property `stateOptions/dataObjectsLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_NONE` enum value to the request property `stateOptions/searchAttributesLoadingPolicy/persistenceLoadingType`
- **2023-07-05** `b341064dfc4b`: 1 warning
  - added the new `LONG_POLL_TIME_OUT_SUB_STATUS` enum value to the `subStatus` response property for the response status `400`
- **2023-05-31** `ca16607cb0f3`: 1 info
  - added the new optional request property `workflowStartOptions/useMemoForDataAttributes`
- **2023-05-08** `13cdae04937f`: 6 info
  - added the new optional request property `stateOptions/dataAttributesLoadingPolicy/lockingKeys`
  - added the new optional request property `stateOptions/dataObjectsLoadingPolicy/lockingKeys`
  - added the new optional request property `stateOptions/searchAttributesLoadingPolicy/lockingKeys`
  - added the new `LOAD_PARTIAL_WITH_EXCLUSIVE_LOCK` enum value to the request property `stateOptions/dataAttributesLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_PARTIAL_WITH_EXCLUSIVE_LOCK` enum value to the request property `stateOptions/dataObjectsLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_PARTIAL_WITH_EXCLUSIVE_LOCK` enum value to the request property `stateOptions/searchAttributesLoadingPolicy/persistenceLoadingType`
- **2023-04-15** `86630172940f`: 1 warning, 4 info
  - added the new `WORKER_API_ERROR` enum value to the `subStatus` response property for the response status `400`
  - the request property `startStateId` became optional
  - added the optional property `originalWorkerErrorDetail` to the response with the `400` status
  - added the optional property `originalWorkerErrorStatus` to the response with the `400` status
  - added the optional property `originalWorkerErrorType` to the response with the `400` status
- **2023-04-13** `59dba7993ef7`: 2 info
  - added the new optional request property `stateOptions/dataAttributesLoadingPolicy`
  - added the new optional request property `workflowStartOptions/idReusePolicy`
- **2023-04-12** `f5d62c720c7a`: 6 info
  - added the new optional request property `stateOptions/executeApiRetryPolicy`
  - added the new optional request property `stateOptions/executeApiTimeoutSeconds`
  - added the new optional request property `stateOptions/skipWaitUntil`
  - added the new optional request property `stateOptions/waitUntilApiFailurePolicy`
  - added the new optional request property `stateOptions/waitUntilApiRetryPolicy`
  - added the new optional request property `stateOptions/waitUntilApiTimeoutSeconds`
- **2023-04-11** `2691858c0c3a`: 1 info
  - added the new optional request property `stateOptions/skipStartApi`
- **2023-04-07** `d772e30a1e53`: 1 warning, 1 info
  - removed the request property `workflowStartOptions/config`
  - added the new optional request property `workflowStartOptions/workflowConfigOverride`
- **2023-04-04** `f426bfa244bf`: 1 info
  - added the new optional request property `workflowStartOptions/config/continueAsNewPageSizeInBytes`
- **2023-03-30** `1ca160d62ae5`: 1 info
  - added the new optional request property `workflowStartOptions/config`
- **2023-03-02** `d9e8179f01ca`: 2 info
  - added the new optional request property `stateOptions/decideApiRetryPolicy/maximumAttemptsDurationSeconds`
  - added the new optional request property `stateOptions/startApiRetryPolicy/maximumAttemptsDurationSeconds`
- **2023-02-27** `8342a6880406`: 1 info
  - added the new optional request property `stateOptions/startApiFailurePolicy`
- **2023-02-03** `46e573464592`: 3 breaking
  - the `stateOptions/decideApiRetryPolicy/backoffCoefficient` request property format changed from no format to `float`
  - the `stateOptions/startApiRetryPolicy/backoffCoefficient` request property format changed from no format to `float`
  - the `workflowStartOptions/retryPolicy/backoffCoefficient` request property format changed from no format to `float`
- **2023-01-12** `f7d20041860e`: 3 warning
  - added the new `UNCATEGORIZED_SUB_STATUS` enum value to the `subStatus` response property for the response status `400`
  - added the new `WORKFLOW_ALREADY_STARTED_SUB_STATUS` enum value to the `subStatus` response property for the response status `400`
  - added the new `WORKFLOW_NOT_EXISTS_SUB_STATUS` enum value to the `subStatus` response property for the response status `400`
- **2022-12-27** `5a146368b6cd`: 1 info
  - added the new optional request property `workflowStartOptions/searchAttributes`
- **2022-12-18** `a325ec23e79c`: 2 info
  - added the new `LOAD_PARTIAL_WITHOUT_LOCKING` enum value to the request property `stateOptions/dataObjectsLoadingPolicy/persistenceLoadingType`
  - added the new `LOAD_PARTIAL_WITHOUT_LOCKING` enum value to the request property `stateOptions/searchAttributesLoadingPolicy/persistenceLoadingType`
- **2022-12-16** `9248feaa5185`: 6 warning, 8 info
  - removed the request property `stateOptions/decideApiRetryPolicy/initialInterval`
  - removed the request property `stateOptions/decideApiRetryPolicy/maximumInterval`
  - removed the request property `stateOptions/startApiRetryPolicy/initialInterval`
  - removed the request property `stateOptions/startApiRetryPolicy/maximumInterval`
  - removed the request property `workflowStartOptions/retryPolicy/initialInterval`
  - removed the request property `workflowStartOptions/retryPolicy/maximumInterval`
  - added the new optional request property `stateOptions/decideApiRetryPolicy/initialIntervalSeconds`
  - added the new optional request property `stateOptions/decideApiRetryPolicy/maximumIntervalSeconds`
  - added the new optional request property `stateOptions/decideApiTimeoutSeconds`
  - added the new optional request property `stateOptions/startApiRetryPolicy/initialIntervalSeconds`
  - added the new optional request property `stateOptions/startApiRetryPolicy/maximumIntervalSeconds`
  - added the new optional request property `stateOptions/startApiTimeoutSeconds`
  - added the new optional request property `workflowStartOptions/retryPolicy/initialIntervalSeconds`
  - added the new optional request property `workflowStartOptions/retryPolicy/maximumIntervalSeconds`
- **2022-12-11** `84d183ca720b`: 3 warning, 6 info
  - removed the request property `stateOptions/queryAttributesLoadingPolicy`
  - removed the request property `stateOptions/searchAttributesLoadingPolicy/attributeKeys`
  - removed the request property `stateOptions/searchAttributesLoadingPolicy/attributeLoadingType`
  - added the new optional request property `stateOptions/dataObjectsLoadingPolicy`
  - added the new optional request property `stateOptions/decideApiRetryPolicy`
  - added the new optional request property `stateOptions/searchAttributesLoadingPolicy/partialLoadingKeys`
  - added the new optional request property `stateOptions/searchAttributesLoadingPolicy/persistenceLoadingType`
  - added the new optional request property `stateOptions/startApiRetryPolicy`
  - added the new optional request property `workflowStartOptions/retryPolicy`
- **2022-11-15** `32141aefeb34`: 1 info
  - added the new optional request property `workflowStartOptions`
- **2022-10-26** `76b52de3323a`: 7 breaking
  - removed the enum value `ALL_UNFINISHED` of the request property `stateOptions/commandCarryOverPolicy/commandCarryOverType`
  - removed the enum value `LOAD_ALL_WITH_EXCLUSIVE_LOCK` of the request property `stateOptions/queryAttributesLoadingPolicy/attributeLoadingType`
  - removed the enum value `LOAD_ALL_WITH_EXCLUSIVE_LOCK` of the request property `stateOptions/searchAttributesLoadingPolicy/attributeLoadingType`
  - removed the enum value `LOAD_PARTIAL_WITHOUT_LOCKING` of the request property `stateOptions/queryAttributesLoadingPolicy/attributeLoadingType`
  - removed the enum value `LOAD_PARTIAL_WITHOUT_LOCKING` of the request property `stateOptions/searchAttributesLoadingPolicy/attributeLoadingType`
  - removed the enum value `LOAD_PARTIAL_WITH_EXCLUSIVE_LOCK` of the request property `stateOptions/queryAttributesLoadingPolicy/attributeLoadingType`
  - removed the enum value `LOAD_PARTIAL_WITH_EXCLUSIVE_LOCK` of the request property `stateOptions/searchAttributesLoadingPolicy/attributeLoadingType`
- **2022-10-09** `0dfb1207bf6c`: 1 breaking
  - removed the enum value `JSON` of the request property `stateInput/encoding`

---

[Operation](https://skmtc.dev/indeedeng/apis/workflow-apis/docs/api/v1/workflow/start/post.md) - [API](https://skmtc.dev/indeedeng/apis/workflow-apis.md) - [Page](https://skmtc.dev/indeedeng/apis/workflow-apis/changes/api/v1/workflow/start/post)
