---
description: Wrangler CLI commands for managing, deploying, and interacting with Cloudflare Workflows.
title: Wrangler commands
image: https://developers.cloudflare.com/og-docs.png
---

[Skip to content](#main-content)

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/workflows/llms.txt  
> Use this file to discover all available pages before exploring further.

# Wrangler commands

Last updated Aug 31, 2026|Copy as Markdown| [View as Markdown](https://4da580d2.previews.developers.cloudflare.com/workflows/reference/wrangler-commands/index.md)| [Agent setup](https://4da580d2.previews.developers.cloudflare.com/agent-setup/)

## `workflows list`

List Workflows associated to account

npmyarnpnpm

```
npx wrangler workflows list
```

```
yarn wrangler workflows list
```

```
pnpm wrangler workflows list
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `--page` `number` default: 1

  Show a sepecific page from the listing, can configure page size using "per-page"
- `--per-page` `number` Configure the maximum number of workflows to show per page

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 describe`

Describe Workflow resource

npmyarnpnpm

```
npx wrangler workflows describe [NAME]
```

```
yarn wrangler workflows describe [NAME]
```

```
pnpm wrangler workflows describe [NAME]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[NAME]` `string` required

  Name of the workflow

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 delete`

Delete workflow - when deleting a workflow, it will also delete it's own instances

npmyarnpnpm

```
npx wrangler workflows delete [NAME]
```

```
yarn wrangler workflows delete [NAME]
```

```
pnpm wrangler workflows delete [NAME]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[NAME]` `string` required

  Name of the workflow

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 trigger`

Trigger a workflow, creating a new instance. Can optionally take a JSON string to pass a parameter into the workflow instance

npmyarnpnpm

```
npx wrangler workflows trigger [NAME] [PARAMS]
```

```
yarn wrangler workflows trigger [NAME] [PARAMS]
```

```
pnpm wrangler workflows trigger [NAME] [PARAMS]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[NAME]` `string` required

  Name of the workflow
- `[PARAMS]` `string` default:

  Params for the workflow instance, encoded as a JSON string
- `--id` `string` Custom instance ID, if not provided it will default to a random UUIDv4

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 list`

Instance related commands (list, describe, terminate, pause, resume)

npmyarnpnpm

```
npx wrangler workflows instances list [NAME]
```

```
yarn wrangler workflows instances list [NAME]
```

```
pnpm wrangler workflows instances list [NAME]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[NAME]` `string` required

  Name of the workflow
- `--reverse` `boolean` default: false

  Reverse order of the instances table
- `--status` `string` Filters list by instance status (can be one of: queued, running, paused, errored, terminated, complete)
- `--page` `number` default: 1

  Show a sepecific page from the listing, can configure page size using "per-page"
- `--per-page` `number` Configure the maximum number of instances to show per page

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 describe`

Describe a workflow instance - see its logs, retries and errors

npmyarnpnpm

```
npx wrangler workflows instances describe [NAME] [ID]
```

```
yarn wrangler workflows instances describe [NAME] [ID]
```

```
pnpm wrangler workflows instances describe [NAME] [ID]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[NAME]` `string` required

  Name of the workflow
- `[ID]` `string` default: latest

  ID of the instance - instead of an UUID you can type 'latest' to get the latest instance and describe it
- `--step-output` `boolean` default: true

  Don't output the step output since it might clutter the terminal
- `--truncate-output-limit` `number` default: 5000

  Truncate step output after x characters

<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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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 send-event`

Send an event to a workflow instance

npmyarnpnpm

```
npx wrangler workflows instances send-event [NAME] [ID]
```

```
yarn wrangler workflows instances send-event [NAME] [ID]
```

```
pnpm wrangler workflows instances send-event [NAME] [ID]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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 send an event to it
- `--type` `string` required

  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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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]
```

- `--local` `boolean` Interact with local dev session
- `--port` `number` default: 8787

  Port of the local dev session (default: 8787)
- `[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>--experimental-provision</code><code>boolean</code> aliases: --x-provisiondefault: true

  Experimental: Enable automatic resource provisioning
- <code>--experimental-auto-create</code><code>boolean</code> alias: --x-auto-createdefault: true

  Automatically provision draft bindings with new resources
- <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

[![](https://4da580d2.previews.developers.cloudflare.com/_astro/logo.te5VL_aD.svg)Docs](https://4da580d2.previews.developers.cloudflare.com/)

```json
{"@context":"https://schema.org","@type":"WebPage","@id":"https://developers.cloudflare.com/workflows/reference/wrangler-commands/#page","headline":"Wrangler commands · Cloudflare Workflows docs","description":"Wrangler CLI commands for managing, deploying, and interacting with Cloudflare Workflows.","url":"https://developers.cloudflare.com/workflows/reference/wrangler-commands/","inLanguage":"en","image":"https://developers.cloudflare.com/og-docs.png","dateModified":"2026-08-31","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/"}}
```