> ## 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 edit

> Edit a resource

Edit a live resource by replacing its spec from a manifest file.

Each subcommand validates the manifest in the required -f file and replaces
the named resource's spec with it.

Resource types:

* deployment
* replicaset
* pod
* job
* cronjob

## Usage

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

## Commands

| Command                | Description       |
| ---------------------- | ----------------- |
| `idyl edit cronjob`    | Edit a cronjob    |
| `idyl edit deployment` | Edit a deployment |
| `idyl edit job`        | Edit a job        |
| `idyl edit pod`        | Edit a pod        |
| `idyl edit replicaset` | Edit a replicaset |

## 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}
# Update a deployment from an edited manifest
idyl edit deployment frontend -f deployment.yaml

# Update a cronjob schedule from an edited manifest
idyl edit cronjob nightly-report -f cronjob.yaml
```

## Subcommand reference

### `idyl edit cronjob`

Edit a cronjob

#### Usage

```bash theme={null}
idyl edit cronjob [name] [flags]
```

#### Aliases

* `cronjobs`
* `cj`

#### Flags

| Flag                                | Description                                                   |
| ----------------------------------- | ------------------------------------------------------------- |
| `-f <string>, --filename <string>`  | Required. Path to the file containing the cronjob definition. |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context.               |

### `idyl edit deployment`

Edit a deployment

#### Usage

```bash theme={null}
idyl edit deployment [name] [flags]
```

#### Aliases

* `deployments`
* `deploy`

#### Flags

| Flag                                | Description                                                      |
| ----------------------------------- | ---------------------------------------------------------------- |
| `-f <string>, --filename <string>`  | Required. Path to the file containing the deployment definition. |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context.                  |

### `idyl edit job`

Edit a job

#### Usage

```bash theme={null}
idyl edit job [name] [flags]
```

#### Aliases

* `jobs`

#### Flags

| Flag                                | Description                                               |
| ----------------------------------- | --------------------------------------------------------- |
| `-f <string>, --filename <string>`  | Required. Path to the file containing the job definition. |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context.           |

### `idyl edit pod`

Edit a pod

#### Usage

```bash theme={null}
idyl edit pod [name] [flags]
```

#### Aliases

* `pods`

#### Flags

| Flag                                | Description                                               |
| ----------------------------------- | --------------------------------------------------------- |
| `-f <string>, --filename <string>`  | Required. Path to the file containing the pod definition. |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context.           |

### `idyl edit replicaset`

Edit a replicaset

#### Usage

```bash theme={null}
idyl edit replicaset [name] [flags]
```

#### Aliases

* `replicasets`
* `rs`

#### Flags

| Flag                                | Description                                                      |
| ----------------------------------- | ---------------------------------------------------------------- |
| `-f <string>, --filename <string>`  | Required. Path to the file containing the replicaset definition. |
| `-n <string>, --namespace <string>` | Namespace name, overriding the current context.                  |