> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idyl.network/llms.txt
> Use this file to discover all available pages before exploring further.

# idyl delete

> Delete resources

Delete resources by name.

Resource types:

* deployment
* replicaset
* pod
* job
* sandbox
* vm
* cronjob
* service
* webapp
* gateway
* httproute
* tlsroute
* referencegrant
* secret

## Usage

```bash theme={null}
idyl delete [resource] [name] [flags]
```

## Aliases

* `rm`

## Commands

| Command                      | Description             |
| ---------------------------- | ----------------------- |
| `idyl delete cronjob`        | Delete a cronjob        |
| `idyl delete deployment`     | Delete a deployment     |
| `idyl delete gateway`        | Delete a Gateway        |
| `idyl delete httproute`      | Delete an HTTPRoute     |
| `idyl delete job`            | Delete a job            |
| `idyl delete pod`            | Delete a pod            |
| `idyl delete referencegrant` | Delete a ReferenceGrant |
| `idyl delete replicaset`     | Delete a replicaset     |
| `idyl delete sandbox`        | Delete a Sandbox        |
| `idyl delete secret`         | Delete a secret         |
| `idyl delete service`        | Delete a Service        |
| `idyl delete tlsroute`       | Delete a TLSRoute       |
| `idyl delete vm`             | Delete a VirtualMachine |
| `idyl delete webapp`         | Delete a WebApp         |

## Flags

| Flag        | Description                |
| ----------- | -------------------------- |
| `-y, --yes` | Skip confirmation prompts. |

## Inherited flags

| Flag                                 | Description                                                        |
| ------------------------------------ | ------------------------------------------------------------------ |
| `-a <string>, --account-id <string>` | Account ID to use, overriding the current context.                 |
| `-c <string>, --context <string>`    | Use the named context for this command.                            |
| `--homedir <string>`                 | Override the configuration directory. Defaults to \~/.config/idyl. |
| `-n <string>, --namespace <string>`  | Namespace to use for this command.                                 |
| `-o <string>, --output <string>`     | Output format (json\|yaml).                                        |
| `-p <string>, --profile <string>`    | Override the access profile for this command.                      |
| `--realm <string>`                   | Override the realm for this command.                               |
| `--subnet <string>`                  | Override the context subnet for this command.                      |

## Examples

```bash theme={null}
# Delete a deployment
idyl delete deployment frontend

# Delete a pod
idyl delete pod worker-7xk2

# Delete a Sandbox before its TTL expires
idyl delete sandbox dev

# Delete a VirtualMachine and its root disk
idyl delete vm dev-vm

# Delete a WebApp without deleting its Service or workload
idyl delete webapp chat-api

# Delete a secret
idyl delete secret ghcr-prod
```

## Subcommand reference

### `idyl delete cronjob`

Delete a cronjob

#### Usage

```bash theme={null}
idyl delete cronjob <name> [flags]
```

#### Aliases

* `cronjobs`
* `cj`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

### `idyl delete deployment`

Delete a deployment

#### Usage

```bash theme={null}
idyl delete deployment <name> [flags]
```

#### Aliases

* `deployments`
* `deploy`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

### `idyl delete gateway`

Delete a Gateway by name.

#### Usage

```bash theme={null}
idyl delete gateway <name> [flags]
```

#### Aliases

* `gateways`
* `gw`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete gateway web
```

### `idyl delete httproute`

Delete an HTTPRoute by name.

#### Usage

```bash theme={null}
idyl delete httproute <name> [flags]
```

#### Aliases

* `httproutes`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete httproute web
```

### `idyl delete job`

Delete a job

#### Usage

```bash theme={null}
idyl delete job <name> [flags]
```

#### Aliases

* `jobs`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

### `idyl delete pod`

Delete a pod

#### Usage

```bash theme={null}
idyl delete pod <name> [flags]
```

#### Aliases

* `pods`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

### `idyl delete referencegrant`

Delete a ReferenceGrant by name.

Deleting a grant closes the cross-namespace references it admitted: routes
in other namespaces stop resolving the Services the grant covered.

#### Usage

```bash theme={null}
idyl delete referencegrant <name> [flags]
```

#### Aliases

* `referencegrants`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete referencegrant from-web
```

### `idyl delete replicaset`

Delete a replicaset

#### Usage

```bash theme={null}
idyl delete replicaset <name> [flags]
```

#### Aliases

* `replicasets`
* `rs`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

### `idyl delete sandbox`

Delete a Sandbox by name.

Deleting a Sandbox removes it before its TTL expires.

#### Usage

```bash theme={null}
idyl delete sandbox <name> [flags]
```

#### Aliases

* `sandboxes`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
# Delete a Sandbox
idyl delete sandbox dev
```

### `idyl delete secret`

Delete a secret by name.

You will be prompted for confirmation unless --yes is provided.

#### Usage

```bash theme={null}
idyl delete secret <name> [flags]
```

#### Aliases

* `secrets`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `--subnet <string>`                 | Subnet whose API host should serve the request. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
# Delete with confirmation
idyl delete secret ghcr-prod --subnet <subnet>

# Delete without confirmation
idyl delete secret ghcr-prod --subnet <subnet> --yes
```

### `idyl delete service`

Delete a Service by name.

Service deletion does not cascade to WebApps. The platform rejects deletion
while active WebApps reference the Service.

#### Usage

```bash theme={null}
idyl delete service <name> [flags]
```

#### Aliases

* `services`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete service chat-api
```

### `idyl delete tlsroute`

Delete a TLSRoute by name.

#### Usage

```bash theme={null}
idyl delete tlsroute <name> [flags]
```

#### Aliases

* `tlsroutes`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete tlsroute db
```

### `idyl delete vm`

Delete a VirtualMachine by name.

Deleting a VirtualMachine stops the guest and removes the durable root disk
owned by that VirtualMachine resource.

#### Usage

```bash theme={null}
idyl delete vm <name> [flags]
```

#### Aliases

* `vms`
* `virtualmachine`
* `virtualmachines`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
# Delete a VirtualMachine
idyl delete vm dev-vm
```

### `idyl delete webapp`

Delete a WebApp by name.

#### Usage

```bash theme={null}
idyl delete webapp <name> [flags]
```

#### Aliases

* `webapps`

#### Flags

| Flag                                | Description                                     |
| ----------------------------------- | ----------------------------------------------- |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context. |
| `-y, --yes`                         | Skip confirmation prompts.                      |

#### Examples

```bash theme={null}
idyl delete webapp chat-api
```