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

> Manage your account

View and manage your IDYL account.

Accounts are the primary unit of resource ownership in IDYL. An account
can be independent (personal) or associated with an organization.

## Usage

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

## Aliases

* `accounts`
* `acc`

## Commands

| Command               | Description                                     |
| --------------------- | ----------------------------------------------- |
| `idyl account delete` | Delete an account                               |
| `idyl account edit`   | Edit an account                                 |
| `idyl account get`    | Get account details or list accessible accounts |
| `idyl account show`   | Show current account details                    |

## 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 accessible accounts
idyl account list

# Show current account details
idyl account show

# Get a specific account's details
idyl account get <account-id>

# Edit an account's display name
idyl account edit <account-id> --set-name "My Account"

# Delete an account (with confirmation)
idyl account delete <account-id>
```

## Subcommand reference

### `idyl account delete`

Delete an account by ID.

This action is irreversible and will remove the account and all associated
resources including namespaces, deployments, and other resources.

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

#### Usage

```bash theme={null}
idyl account delete <id> [flags]
```

#### Flags

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

#### Examples

```bash theme={null}
# Delete account (with confirmation)
idyl account delete <account-id>

# Delete without confirmation
idyl account delete <account-id> --yes
```

### `idyl account edit`

Edit account settings.

Only the specified flags are updated; other settings remain unchanged.

#### Usage

```bash theme={null}
idyl account edit <id> [flags]
```

#### Flags

| Flag                             | Description                                            |
| -------------------------------- | ------------------------------------------------------ |
| `-o <string>, --output <string>` | Output format: table, json, or yaml. Default: `table`. |
| `--set-name <string>`            | Set the account display name.                          |

#### Examples

```bash theme={null}
# Update an account's display name
idyl account edit <account-id> --set-name "My New Account Name"
```

### `idyl account get`

Get details of a specific account, or list all accessible accounts.

With no arguments, lists all accounts the current identity can access.
With an argument, gets details of that account by ID.

#### Usage

```bash theme={null}
idyl account get [id] [flags]
```

#### Aliases

* `list`
* `ls`

#### Flags

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

#### Examples

```bash theme={null}
# List all accessible accounts
idyl account get

# List accessible accounts in JSON format
idyl account get -o json
```

### `idyl account show`

Show details of the current account from the active context.

#### Usage

```bash theme={null}
idyl account show [flags]
```

#### Flags

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

#### Examples

```bash theme={null}
# Show current account details
idyl account show

# Show current account in JSON format
idyl account show -o json
```