---
title: "wendy cloud device unenroll"
description: "Unenroll a device and remove it from Wendy Cloud"
---

## Syntax

```sh
wendy cloud device unenroll [flags]
```

## Examples

```sh
wendy cloud device unenroll --help
```

## Arguments

No positional arguments are declared in the command synopsis.

## Flags

Flags below include inherited options. Types and defaults come from the CLI source. An empty default means no value is configured.

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--broker-url` | string | (empty) | Tunnel broker host:port (default: cloud :443 endpoint, otherwise <cloud-host>:50052) |
| `--cloud-grpc` | string | (empty) | Cloud gRPC endpoint to use for cleanup (defaults to the device's enrolled cloud host) |
| `--device` | string | (empty) | Target device hostname; `wendy run` accepts a comma-separated list to deploy one build to several devices (needs a remote build host and --detach). Defaults to $WENDY_DEVICE, then the saved default device |
| `--json` | bool | `false` | Output in JSON format |
| `--yes` | bool | `false` | Skip the confirmation prompt |

## Output

Output depends on the operation and selected target. Use the command help for additional guidance..

## JSON output

The global `--json` option requests machine-readable output. The CLI also selects JSON mode when no interactive terminal is attached. Support and payloads are command-specific; this flag does not guarantee a single JSON document for commands that stream logs or invoke build tools. Consult Details before parsing command output.

## Exit codes

The CLI entry point returns `0` on success and for its user-cancelled or default-cleared results. Other returned errors exit with `1` and print a diagnostic to stderr. Some operations may terminate through subprocess or signal handling; do not infer application health from the CLI exit code alone.

## Common errors

Check argument values and flag combinations against the synopsis above. For discovery, build, port, and readiness failures, see [deployment troubleshooting](../../../../../errors/). Command-specific constraints are in Details.

## See also

- [wendy cloud device](../../../../../reference/cli/cloud/device/)
- [CLI conventions and configuration](../../../../../reference/)

## Details

Reverses 'wendy device enroll': deletes the device's enrollment certificates and provisioning state (the agent restarts into unprovisioned mode), then revokes the device's certificates and deletes its asset record in Wendy Cloud.

Use the command help for additional guidance.