npm / @upstash/workflow
@upstash/workflow
What changed in @upstash/workflow 0.2 to 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-07.
9 breaking16 new APIs and options4 behavior and defaults1 tooling6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@upstash/workflow 132 changes
Breaking changes 9
Single-resource endpoints reject an empty id.
Labels are validated as alphanumeric.
A 412 response from QStash now throws a non-retriable error.
The agents API was removed.
The AI SDK API was removed.
Middleware replaces the logger.
onStepFinish was removed.
Serve options were removed, and serve option types were simplified.
The stringifyBody parameter was removed.
New APIs and options 14
Adds step-level flow control and retries, giving developers control over flow and retry behavior at the step level.
Adds CALLBACK_CANCELED to failure callback state unions.
Bulk workflow run cancel supports multi-value filters.
FailureFunctionLog gains the nextDeliveryTime field.
Failing step names are reported via the Upstash-Error-Step-Name header.
Multi label runs are added.
Adds context.retried.
The notify option adds workflowRunId.
The trigger adds a redacted field.
Invoke calls can now include labels, in addition to trigger calls.
React Router is now supported.
The workflow run creation time is available on context and is passed in invoke requests.
Adds multi-region support.
An unknown SDK feature was added.
Behavior and default changes 4
Calling serve() eagerly starts the QStash dev server across all adapters.
This header is sent so runs with the same ID aren't deduplicated.
Schema checks are skipped for third party call results.
User headers are forwarded via the server.
Tooling 1
Adds support for the qstash-js auto dev server.
Fixes and other changes 4
Flow control keys are validated as alphanumeric.
Missing bulk action methods were added to the SDK.
Failures involving the failure function now include more information.
Errors were updated.
@upstash/workflow 0.24 changes
New APIs and options 2
Adds the ability to wait for a webhook.
Adds the WorkflowRetryAfterError error.
Fixes and other changes 2
Includes QStash client headers in the invoke body.
Fixes a JSON parsing issue in the failure function response.