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

# aether token

> Create and manage platform API keys for the REST API

# aether token

Manage platform API keys — long-lived `aether_` bearer keys for programmatic access to the [REST API](/api-reference/overview). Pass a key as the `AETHER_TOKEN` environment variable or in an `Authorization: Bearer` header.

**Alias:** `tokens`

<Note>
  Three things are easy to confuse:

  * **`aether token`** — platform keys (`aether_…`) for the REST API.
  * **[`aether apikey`](/cli/apikey)** — your own LLM provider keys (BYO key).
  * **[`aether auth token`](/cli/auth)** — prints the current session JWT.
</Note>

## Usage

```bash theme={null}
aether token <subcommand> [flags]
```

## Subcommands

| Subcommand    | Description                     |
| ------------- | ------------------------------- |
| `create`      | Create a new key (printed once) |
| `list`        | List your keys                  |
| `revoke <id>` | Revoke a key                    |

## Create

```bash theme={null}
aether token create --name "CI pipeline"
```

| Flag     | Description                            |
| -------- | -------------------------------------- |
| `--name` | Name for the key (prompted if omitted) |

The full key (`aether_…`) is printed once and never shown again — save it immediately. Use it like:

```bash theme={null}
export AETHER_TOKEN=aether_...
curl -H "Authorization: Bearer $AETHER_TOKEN" https://api.runaether.dev/v1/profile
```

## List

```bash theme={null}
aether token list
```

Shows each key's ID, name, prefix, creation time, last-used time, and whether it's active or revoked. The raw key is not retrievable here.

## Revoke

```bash theme={null}
aether token revoke <id>
aether token revoke <id> --force
```

`<id>` accepts a unique ID prefix. Pass `--force` to skip the confirmation prompt. Revoking is immediate and cannot be undone.

See [authentication](/api-reference/authentication) for how keys authorize REST requests.