Workflows (2)·续
Type of the workflow event
- --payload string default: {}
JSON string for the workflow event (e.g., '{"key": "value"}')
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
workflows instances terminate
Terminate a workflow instance
npmyarnpnpm
npx wrangler workflows instances terminate <NAME> <ID>
yarn wrangler workflows instances terminate <NAME> <ID>
pnpm wrangler workflows instances terminate <NAME> <ID>
--localbooleanInteract with local dev session--portnumberdefault: 8787
Port of the local dev session (default: 8787)
- --json boolean default: false
Output the raw API response as JSON
- <NAME> string required
Name of the workflow
- <ID> string required
ID of the instance - instead of an UUID you can type 'latest' to get the latest instance and describe it
- --rollback boolean default: false
Run registered rollback handlers before terminating
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
workflows instances restart
Restart a workflow instance
npmyarnpnpm
npx wrangler workflows instances restart <NAME> <ID>
yarn wrangler workflows instances restart <NAME> <ID>
pnpm wrangler workflows instances restart <NAME> <ID>
--localbooleanInteract with local dev session--portnumberdefault: 8787
Port of the local dev session (default: 8787)
- --json boolean default: false
Output the raw API response as JSON
- <NAME> string required
Name of the workflow
- <ID> string required
ID of the instance - instead of an UUID you can type 'latest' to get the latest instance and describe it
- --from-step-name string Name of the step to restart from
- --from-step-count number 1-based occurrence of the step name/type to restart from (defaults to 1)
- --from-step-type string Step type to restart from, used when the same name is shared across step types (defaults to do)
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
workflows instances pause
Pause a workflow instance
npmyarnpnpm
npx wrangler workflows instances pause <NAME> <ID>
yarn wrangler workflows instances pause <NAME> <ID>
pnpm wrangler workflows instances pause <NAME> <ID>
--localbooleanInteract with local dev session--portnumberdefault: 8787
Port of the local dev session (default: 8787)
- --json boolean default: false
Output the raw API response as JSON
- <NAME> string required
Name of the workflow
- <ID> string required
ID of the instance - instead of an UUID you can type 'latest' to get the latest instance and pause it
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
workflows instances resume
Resume a workflow instance
npmyarnpnpm
npx wrangler workflows instances resume <NAME> <ID>
yarn wrangler workflows instances resume <NAME> <ID>
pnpm wrangler workflows instances resume <NAME> <ID>
--localbooleanInteract with local dev session--portnumberdefault: 8787
Port of the local dev session (default: 8787)
- --json boolean default: false
Output the raw API response as JSON
- <NAME> string required
Name of the workflow
- <ID> string required
ID of the instance - instead of an UUID you can type 'latest' to get the latest instance and resume it
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
workflows instances delete
Delete workflow instances
npmyarnpnpm
npx wrangler workflows instances delete <NAME> [ID]
yarn wrangler workflows instances delete <NAME> [ID]
pnpm wrangler workflows instances delete <NAME> [ID]
--localbooleanInteract with local dev session--portnumberdefault: 8787
Port of the local dev session (default: 8787)
- --json boolean default: false
Output the raw API response as JSON
- <NAME> string required
Name of the workflow
- [ID] string IDs of the instances - you can type 'latest' to get the latest instance and delete it
- --filename string Path to a JSON file containing an array of instance IDs
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
Was this helpful?
YesNo
On this page
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/workflows/#page","headline":"Workflows","description":"Wrangler commands for managing and configuring Cloudflare Workflows.","url":"https://developers.cloudflare.com/workers/wrangler/commands/workflows/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/commands/workflows/og.png?v=5f128d6707007100","dateModified":"2026-04-23","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
description: Use a configuration file to customize the development and deployment setup for your Worker project and other Developer Platform products. title: Configuration image: https://developers.cloudflare.com/workers/wrangler/configuration/og.png?v=757cd9bbad5852dd
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.
Docs