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

# Characters

> The 5 adside commands for Characters.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside characters --help` to see what your installed version has.

## characters

### characters create

Create a character from 1 to 8 reference images of this workspace, best first; the first is the cover a talking avatar speaks from.

Beta: this command may still change.

```bash theme={null}
adside characters create --name <name> --kind ai_person|real_person|mascot [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--name` (required) | `<name>` | |
| `--kind` (required) | `ai_person\|real_person\|mascot` | |
| `--references` | `'<json>'` | |
| `--handle` | `<handle>` | |
| `--consent-confirmed` | `true\|false` | |
| `--identity-notes` | `<identity-notes>` | |
| `--voice-id` | `<id>` | |
| `--reference` (repeatable) | `<ref>` | A reference image, best first (the first is the cover): a local file (uploaded to the library) or an asset ID (repeatable) |

### characters delete

Delete a character; its reference images stay in the library, and media made with it is unchanged.

Beta: this command may still change.

```bash theme={null}
adside characters delete --character <character>
```

### characters get

Get a character by handle or ID, with its reference images in order.

Beta: this command may still change.

```bash theme={null}
adside characters get --character <character>
```

### characters list

List the workspace's characters: the people and mascots that media generation keeps the same.

Beta: this command may still change.

```bash theme={null}
adside characters list
```

### characters update

Change a character; references replace the whole list, and null clears identity notes or the voice.

Beta: this command may still change.

```bash theme={null}
adside characters update --character <character> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--character` (required) | `<character>` | |
| `--name` | `<name>` | |
| `--handle` | `<handle>` | |
| `--kind` | `ai_person\|real_person\|mascot` | |
| `--consent-confirmed` | `true\|false` | |
| `--identity-notes` | `<identity-notes>` | |
| `--voice-id` | `<id>` | |
| `--references` | `'<json>'` | |
| `--reference` (repeatable) | `<ref>` | A reference image, best first (the first is the cover): a local file (uploaded to the library) or an asset ID (repeatable) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.