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

> View and manage regions

View available regions and manage account region deployment access.

Regions are user-facing placement domains for subnets. When you create a
subnet in a region, IDYL chooses the concrete placement automatically.

## Usage

```bash theme={null}
idyl region
```

## Commands

| Command               | Description                              |
| --------------------- | ---------------------------------------- |
| `idyl region disable` | Disable a region for account deployments |
| `idyl region enable`  | Enable a region for account deployments  |
| `idyl region list`    | List regions                             |

## 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}
# List regions
idyl region list

# Enable a region for account deployments
idyl region enable us-east

# Disable a region for account deployments
idyl region disable us-east
```

## Subcommand reference

### `idyl region disable`

Disable a region for account deployments.

Existing workloads are not stopped, but new deployments into subnets in this
region will be blocked once the region is disabled.

#### Usage

```bash theme={null}
idyl region disable <region> [flags]
```

#### Aliases

* `unapprove`

#### Flags

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

#### Examples

```bash theme={null}
idyl region disable us-east
idyl region unapprove us-east
idyl region disable us-east --yes
```

### `idyl region enable`

Enable a region for account deployments.

The current account can only create new workloads in approved subnets whose
region is enabled for the account.

#### Usage

```bash theme={null}
idyl region enable <region> [flags]
```

#### Aliases

* `approve`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |

#### Examples

```bash theme={null}
idyl region enable us-east
idyl region approve us-east
```

### `idyl region list`

List regions

#### Usage

```bash theme={null}
idyl region list [flags]
```

#### Aliases

* `ls`

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |