---
title: "aeontel api"
description: "Manage workspace HTTP APIs"
section: "CLI"
group: "Commands"
order: 802
---

## Api commands

### `aeontel api list`

List apis in a workspace

```ts
aeontel api list --workspace <id>
```

```bash
aeontel api list --workspace wsp_...
```

### `aeontel api create`

Create an api

```ts
aeontel api create <handle> --workspace <id> --name <name> [--description <desc>] [--auth <json>]
```

```bash
aeontel api create my-handle --workspace wsp_... --name "My name"
```

### `aeontel api get`

Get api details

```ts
aeontel api get <id>
```

```bash
aeontel api get id_...
```

### `aeontel api update`

Update an api

```ts
aeontel api update <id> [--handle <handle>] [--name <name>] [--description <desc>] [--auth <json>] [--enabled] [--disabled]
```

```bash
aeontel api update id_...
```

### `aeontel api delete`

Soft-delete an api (restorable until retention expires)

```ts
aeontel api delete <id> [--cascade]
```

```bash
aeontel api delete id_...
```

### `aeontel api restore`

Restore a soft-deleted api

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

```bash
aeontel api restore id_...
```