infochanged

Workflows, Workers - Delete Workflow instances individually or in batches

Announced: 2026-09-17
Tags: Workflows, Workers
Severity: info, set by reef/rss-rule-v1
Source: https://developers.cloudflare.com/changelog/post/2026-09-17-instance-delete/

You can now delete one or up to 100 Workflow instances and their stored state via the <a href="https://developers.cloudflare.com/workflows/build/workers-api/">Workflows API</a> or Wrangler 4.125.0 and later. Deleting an instance frees its stored state and stops its current execution. <a href="https://developers.cloudflare.com/workflows/reference/pricing/#storage-usage">Storage billing</a> is based on the average daily peak. Delete one instance by calling <a href="https://developers.cloudflare.com/workflows/build/workers-api/#delete"><code>delete()</code></a> on its handle: <figure class="nb-code-figure" data-nb-lang="ts"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>const instance = await env.MY_WORKFLOW.get("instance-abc"); await instance.delete();</code></pre></figure> If a Workflow deletes its own instance, execution stops during <code>await instance.delete()</code>. Code after the call does not run. Delete multiple instances by calling <a href="https://developers.cloudflare.com/workflows/build/workers-api/#deletebatch"><code>deleteBatch()</code></a> on the Workflow binding: <figure class="nb-code-figure" data-nb-lang="ts"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code>const result = await env.MY_WORKFLOW.deleteBatch([ "instance-abc", "instance-def", ]); console.log(result.deleted); console.log(result.errors);</code></pre></figure> The batch result contains <code>{ id }</code> entries for successful deletions and per-instance errors. IDs that do not exist are returned as errors. Duplicate IDs count toward the limit and are deleted once, with the result repeated for each input position. Wrangler accepts positional instance IDs, a file containing a top-level JSON array of strings, or both, up to 100 IDs total. Use <code>latest</code> to delete the most recently created instance. Use <code>--local</code> against a local <code>wrangler dev</code> session: <figure class="nb-code-figure nb-code-figure-titled" data-nb-lang="json"><figcaption class="nb-code-title">instance-ids.jsonjson</figcaption><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="json" data-nb-lang="json"><code>["instance-abc", "instance-def"]</code></pre></figure> <figure class="nb-code-figure" data-nb-lang="sh"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="sh" data-nb-lang="sh"><code>npx wrangler workflows instances delete my-workflow <INSTANCE_ID> npx wrangler workflows instances delete my-workflow <INSTANCE_ID> <INSTANCE_ID> npx wrangler workflows instances delete my-workflow latest npx wrangler workflows instances delete my-workflow --filename ./instance-ids.json npx wrangler workflows instances delete my-workflow <INSTANCE_ID> --local</code></pre></figure> For more information, refer to <a href="https://developers.cloudflare.com/workflows/build/trigger-workflows/#delete-workflow-instances">Delete Workflow instances</a>, <a href="https://developers.cloudflare.com/workflows/build/workers-api/#delete"><code>delete</code></a>, and <a href="https://developers.cloudflare.com/workflows/build/workers-api/#deletebatch"><code>deleteBatch</code></a>.

The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.