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

# astro env variable link list

> Show the Deployments a Workspace environment variable is linked to.

<Info>
  This command is only available on Astro.
</Info>

Show every Deployment that a Workspace-scoped environment variable is linked to or excluded from. Identify the variable with either `--variable-key` or `--variable-id`.

## Usage

```bash wrap theme={null}
astro env variable link list
```

## Options

| Option | Description | Possible Values |
| - | - | - |
| `--variable-key` | The key of the Workspace variable. Provide either this or `--variable-id`. | Any string |
| `--variable-id` | The ID of the Workspace variable. Provide either this or `--variable-key`. | Any valid variable ID |
| `--format` | The output format. Defaults to `table`. | `table`, `json`, or `yaml` |
| `--include-secrets` | Surface secret values in the output. Requires an Organization policy that allows it. | None |
| `--workspace-id` | Set the Workspace scope. Defaults to your current Workspace from CLI context. | Any valid Workspace ID |

## Examples

```bash wrap theme={null}
# Show every Deployment a Workspace variable is linked to or excluded from
astro env variable link list --variable-key DATABASE_URL --workspace-id <workspace-id>
```

## Related commands

* [`astro env variable link create`](/docs/cli/v1.46/astro-env-variable-link-create)
* [`astro env variable link delete`](/docs/cli/v1.46/astro-env-variable-link-delete)