Changelog

Subscribe to RSS

2025-05-07

Search for specific Workflows

With this release, you can search Workflows by name via API.

2025-04-29

Workflow deletion and more

Workflows can now be deleted (from the Dashboard/UI or via API), and the maximum length limit for event types and instance IDs was increased to 100 characters.

Also, this release fixes a bug where a delay of 0 in step config retries would fail.

2025-04-07

Workflows is now Generally Available

Workflows is now Generally Available (or "GA").

This release includes the following new features:

• A new waitForEvent API that allows a Workflow to wait for an event to occur before continuing execution.
• Increased concurrency: you can run up to 4,500 Workflow instances concurrently — and this will continue to grow.
• Improved observability, including new CPU time metrics that allow you to better understand which Workflow instances are consuming the most resources and/or contributing to your bill.
• Support for vitest for testing Workflows locally and in CI/CD pipelines.

More information available in the changelog.

2025-02-25

Concurrent Workflow instances limits increased

Workflows now supports up to 4,500 concurrent (running) instances, up from the previous limit of 100.

More information available in the changelog.

2025-02-11

Behavior improvements

Improved Workflows execution that prevents Workflows instances from getting stuck, and allows stuck instances to become unstuck.

Also, improved the reliability of Workflows step retry counts, and improved Instance ID validation.

2025-01-23

Major bugfixes and improvements

With this release, some bug were fixed:

• event.timestamp is now Date, fixing a regression.
• Fixed issue where instances without metadata were not terminated as expected.

Also, this release makes Workflows execution more reliable for accounts with high loads.

2025-01-09

Improved Wrangler local dev experience for steps' output, matching production

Previously, in local dev, the output field would return the list of successful steps outputs in the workflow. This is not expected behavior compared to production workflows (where the output is the actual return of the run function).

This release aligns the local dev output field behavior with the production behavior.

2024-12-19

Better instance control, improved queued logic, and step limit increased

Workflows can now be terminated and pause instances from a queued state and the ID of an instance is now exposed via the WorkflowEvent parameter.

Also, the mechanism to queue instances was improved to force miss-behaved queued instances to be automatically errored.

Workflows now allow you to define up to 1024 steps in a single Workflow definition, up from the previous limit of 512. This limit will continue to increase during the course of the open beta.

2024-12-09

New queue instances logic

Introduction of a new mechanism to queue instances, which will prevent instances from getting stuck on queued status forever.

2024-11-30

Step limit increased

Workflows now allow you to define up to 512 steps in a single Workflow definition, up from the previous limit of 256. This limit will continue to increase during the course of the open beta.

If you have Workflows that need more steps, we recommend delegating additional work to other Workflows by triggering a new Workflow from within a step and passing any state as parameters to that Workflow instance.

2024-11-21

Fixed create instance API in Workers bindings

You can now call create() without any arguments when using the Workers API for Workflows. Workflows will automatically generate the ID of the Workflow on your behalf.

This addresses a bug that caused calls to create() to fail when provided with no arguments.

2024-11-20

Multiple Workflows in local development now supported

Local development with wrangler dev now correctly supports multiple Workflow definitions per script.

There is no change to production Workflows, where multiple Workflow definitions per Worker script was already supported.

2024-10-23

Workflows is now in public beta!

Workflows, a new product for building reliable, multi-step workflows using Cloudflare Workers, is now in public beta. The public beta is available to any user with a free or paid Workers plan.

A Workflow allows you to define multiple, independent steps that encapsulate errors, automatically retry, persist state, and can run for seconds, minutes, hours or even days. A Workflow can be useful for post-processing data from R2 buckets before querying it, automating a Workers AI RAG pipeline, or managing user signup flows and lifecycle emails.

You can learn more about Workflows in our announcement blog, or start building in our get started guide.