Skip to content
21 changes: 21 additions & 0 deletions src/content/changelog/workflows/2025-11-10-instance-restarts.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: Instance restarts now supported in Workflows
description: You can now restart an instance of your workflow without losing its concurrency spot
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

capitalize Workflow?

products:
- workflows
- workers
date: 2025-11-10
---

You can now restart a [Cloudflare Workflow](/workflows/) instance via the [API](/api/resources/workflows/methods/list/), [Wrangler](/workers/wrangler/commands/#workflows), or [Workers](/workflows/build/workers-api/):

```typescript
let instance = await env.MY_WORKFLOW.get("abc-123");
await instance.restart(); // Returns Promise<void>
```

You may want to [restart an instance](/workflows/build/trigger-workflows/#restart-a-workflow) if the Workflow has been updated, the parameters have changed, or the Workflow has reached its step limit. Restarting an instance will immediately cancel any in-progress steps, erase any intermediate state, and treat the Workflow as if it was run for the first time.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be good to add a sentence here of why this is important


If the instance is already running, the restart will not lose its concurrency slot (limit of 10,000 concurrent instances). However, the restarted instance will count towards the creation rate limit (100 instances per second).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a bit confusing to parse. i would clarify concurrency vs. creation here a bit more. i.e. does this help if i have 10,001 instances? or is this useful in general?
what does creation mean here?


For more information on concurrency and creation limits, refer to [Workflow limits](/workflows/reference/limits/).
Loading