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

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

Rotate an Astro [Deployment API Token](/docs/astro/deployment-api-tokens).

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

## Usage

```sh wrap theme={null}
astro deployment token rotate <token-id> --deployment-id=<deployment-id> [flags]
```

## Options

| Option                | Description                                                                                                  | Possible Values |
| --------------------- | ------------------------------------------------------------------------------------------------------------ | --------------- |
| `-c`,`--clean-output` | Print only the token as output. Use when writing scripts that run the command.                               | N/A             |
| `-f`, `--force`       | Rotate the Deployment API token without showing a warning.                                                   | N/A             |
| `-t`,`--name`         | The name of the token to be rotated. If the name contains a space, specify the entire name within quotes "". | String          |

## Examples

```bash wrap theme={null}
astro deployment token rotate --deployment-id=clukapi6r000008l58530cg8i --name "My token"
```

## Related commands

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