---
title: "aeontel api-key"
description: "Manage API keys"
section: "CLI"
group: "Commands"
order: 803
---

## Api-key commands

### `aeontel api-key list`

List API keys in a workspace

```ts
aeontel api-key list [--workspace <id>] [--type <type>]
```

```bash
aeontel api-key list
```

### `aeontel api-key create`

Create a new API key

```ts
aeontel api-key create <name> [--workspace <id>] [--type <type>]
```

```bash
aeontel api-key create "My name"
```

### `aeontel api-key update`

Update an API key (e.g. rename)

```ts
aeontel api-key update <id> [--name <name>]
```

```bash
aeontel api-key update id_...
```

### `aeontel api-key delete`

Soft-delete an API key (restorable until retention expires)

```ts
aeontel api-key delete <id>
```

```bash
aeontel api-key delete id_...
```

### `aeontel api-key restore`

Restore a soft-deleted API key

```ts
aeontel api-key restore <id>
```

```bash
aeontel api-key restore id_...
```

### `aeontel api-key roll`

Regenerate an API key's secret (previous key is invalidated)

```ts
aeontel api-key roll <id>
```

```bash
aeontel api-key roll id_...
```