> ## 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 deployment token list

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

List all [API tokens](/docs/astro/deployment-api-tokens) belonging to a Deployment.

To use an API token in an automated process, see [Authenticate an automation tool](/docs/astro/automation-authentication).

## Usage

```sh wrap theme={null}
astro deployment token list --deployment-id=<deployment-id>
```

## Options

| Option            | Description                          | Possible Values                                                           |
| ----------------- | ------------------------------------ | ------------------------------------------------------------------------- |
| `--deployment-id` | The Deployment to list tokens for.   | A valid Deployment ID                                                     |
| `--verbosity`     | The log level.                       | `debug`, `info`, `warn`, `error`, `fatal`, or `panic`. Default is `warn`. |
| `--workspace-id`  | The Workspace ID for the Deployment. | A valid Workspace ID                                                      |

## Output

| Output        | Description                                                                  | Data Type |
| ------------- | ---------------------------------------------------------------------------- | --------- |
| `ID`          | The token ID.                                                                | String    |
| `NAME`        | The name of the token.                                                       | String    |
| `DESCRIPTION` | The description of the API Token.                                            | String    |
| `SCOPE`       | Whether the API Token is scoped to a Deployment, Workspace, or Organization. | String    |
| `CREATED`     | How long ago the token was created in days.                                  | String    |
| `CEATED BY`   | The name of the user entity who created the token.                           | String    |

## Examples

```bash wrap theme={null}
# List tokens for a single Deployment
astro deployment token list --deployment-id=clukapi6r000008l58530cg8i
```

## Related commands

* [`astro deployment token create`](/docs/cli/v1.39/astro-deployment-create)
* [`astro deployment token update`](/docs/cli/v1.39/astro-deployment-token-update)
* [`astro deployment token rotate`](/docs/cli/v1.39/astro-deployment-token-rotate)