Breaking change on workflow id reuse policy#5102
Open
cicoyle wants to merge 2 commits intodapr:v1.18from
Open
Conversation
Signed-off-by: Cassandra Coyle <[email protected]>
Contributor
There was a problem hiding this comment.
Pull request overview
Documents a breaking behavior change in Dapr Workflows where workflow instance IDs can no longer be reused after completion/failure.
Changes:
- Adds an entry to the breaking changes/deprecations tracker noting removal of workflow instance ID reuse.
- Updates workflow concepts docs to state instance IDs are not reusable after completion/failure.
- Updates workflow architecture docs to remove mention of instance ID reuse from
metadatakey description.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md | Adds a new row documenting the removal of workflow instance ID reuse policy (with release/version info). |
| daprdocs/content/en/developing-applications/building-blocks/workflow/workflow-features-concepts.md | Updates workflow identity guidance to state instance IDs cannot be reused. |
| daprdocs/content/en/developing-applications/building-blocks/workflow/workflow-architecture.md | Updates actor state key documentation to remove reuse-specific rationale for the generation field. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
daprdocs/content/en/operations/support/breaking-changes-and-deprecations.md
Show resolved
Hide resolved
Workflow instance IDs can no longer be reused by creating a new workflow with the same ID. Workflow histories are immutable records and should only be removed through the purge API or a retention policy, not overwritten via workflow creation. The instance ID reuse policy option (IGNORE, TERMINATE actions) previously available in some SDKs has also been removed. Ref: dapr/dapr#9739 Signed-off-by: joshvanl <[email protected]>
JoshVanL
approved these changes
Apr 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
We are removing the reuse policy for the Workflows API in this PR