# hub tokens

Source: https://docs.myhub.host/cli/tokens

## Usage

```sh
hub tokens [options] [command]
```

## `hub tokens list`

List deploy token metadata; secrets are never returned.

### Usage

```sh
hub tokens list [options]
```

### Options

| Option   | Description                 |
| -------- | --------------------------- |
| `--json` | Return a structured result. |

## `hub tokens create`

Create a deploy token; copy it once into your CI `HUB_TOKEN` secret.

### Usage

```sh
hub tokens create [options] <name>
```

### Arguments

| Argument | Description              |
| -------- | ------------------------ |
| `<name>` | A label for this CI job. |

### Options

| Option          | Description                                               |
| --------------- | --------------------------------------------------------- |
| `--days <days>` | Expires in 1–90 days. Default: `30`.                      |
| `--json`        | Return a structured result including the one-time secret. |

## `hub tokens revoke`

Revoke a deploy token immediately.

### Usage

```sh
hub tokens revoke [options] <id>
```

### Arguments

| Argument | Description                      |
| -------- | -------------------------------- |
| `<id>`   | Token ID from `hub tokens list`. |

### Options

| Option   | Description                 |
| -------- | --------------------------- |
| `--json` | Return a structured result. |