> ## 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 workspace token create

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

Create a Workspace API token in your current Workspace.

## Usage

```sh wrap theme={null}
astro workspace token create
```

## Options

| Option           | Description                                                                | Valid Values                                                                               |
| ---------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| `--clean-output` | Print only the token as output. Use this flag in automated workflows.      | None                                                                                       |
| `--description`  | The description for the token                                              | Any string surrounded by quotations                                                        |
| `--expiration`   | The expiration date for the token. By default there is no expiration date. | Any integer between 1 and 3650, used to represent days                                     |
| `--name`         | The name for the token.                                                    | Any string surrounded by quotations                                                        |
| `--role`         | The token's role in the Workspace.                                         | One of `WORKSPACE_MEMBER`, `WORKSPACE_AUTHOR`, `WORKSPACE_OPERATOR`, or `WORKSPACE_OWNER`. |

## Examples

```sh wrap theme={null}
astro workspace token create --name "My production API token" --role WORKSPACE_MEMBER
```

## Related commands

* [astro workspace token update](/docs/cli/v1.40/astro-workspace-token-update)
* [astro workspace token rotate](/docs/cli/v1.40/astro-workspace-token-rotate)
* [astro workspace switch](/docs/cli/v1.40/astro-workspace-switch)