Source: https://cli.nylas.com/docs/commands/workflow-delete

# nylas workflow delete

Delete a workflow

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## What does nylas workflow delete do?

The nylas workflow delete command deletes a workflow. It is part of the Hosted Workflows commands, which automated workflows triggered by Nylas events (e.g., bookings).

## Usage

```bash
nylas workflow delete
```

## Flags

| Flag | Description |
| --- | --- |
| --grant-id string | Grant ID or email for grant-scoped workflows |
| --scope string | Workflow scope: app or grant |
| --yes(-y) | Skip confirmation prompts |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |

## Examples

The nylas workflow delete command deletes a workflow.

### JSON output for scripting

```bash
nylas workflow delete --json
```

### Filter by grant-id

```bash
nylas workflow delete --grant-id <value> --json
```

## Troubleshooting

### Command not found or fails

Run `nylas auth config` and `nylas auth login` to authenticate first.

## Related commands

[nylas workflow createCreate a workflow](https://cli.nylas.com/docs/commands/workflow-create)

[nylas workflow listList workflows](https://cli.nylas.com/docs/commands/workflow-list)

[nylas workflow showShow workflow details](https://cli.nylas.com/docs/commands/workflow-show)

[nylas workflow updateUpdate a workflow](https://cli.nylas.com/docs/commands/workflow-update)

## Recommended guides

[Thunderbird vs Nylas: GUI vs CLI emailThunderbird is a desktop GUI email client with OAuth and calendar built in. Compare it to a scriptable, headless CLI for servers, cron jobs, and AI agents.](https://cli.nylas.com/guides/nylas-vs-thunderbird)

[Build a Vellum Email AgentGive a Vellum workflow email by wrapping the Nylas CLI as a code-node tool — one subprocess call per action, JSON in and out, across 6 providers, no SDK.](https://cli.nylas.com/guides/vellum-email-agent)

[Pipedream vs Nylas for Email AutomationPipedream wires 3,000+ apps with event workflows and code steps. Nylas is a native email API with a CLI for agents and cron. Compare as a Pipedream alternative.](https://cli.nylas.com/guides/pipedream-vs-nylas)

[Detect Calendar Conflicts from the CLISpot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.](https://cli.nylas.com/guides/detect-calendar-conflicts-cli)

[Block Focus Time on Your Calendar (CLI)Context-switching costs 23 minutes of focus per interruption. Block focus time on Google Calendar from your terminal so meetings can't eat your deep-work slots.](https://cli.nylas.com/guides/block-focus-time-cli)

[Build a Dify Email AgentWrap the Nylas CLI as a Dify custom tool: upload one OpenAPI schema and your Dify email agent reads, searches, and drafts across Gmail, Outlook, and 4 more.](https://cli.nylas.com/guides/dify-email-agent)

Run `nylas workflow delete --help` for full help output.