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

# Personas

> Manage simulated personas with the Coval CLI

## List Personas

```bash theme={null}
coval personas list [OPTIONS]
```

| Option        | Type   | Default | Description       |
| ------------- | ------ | ------- | ----------------- |
| `--filter`    | string | —       | Filter expression |
| `--page-size` | number | 50      | Results per page  |
| `--order-by`  | string | —       | Sort order        |

**Output columns:** ID, NAME, VOICE, LANGUAGE, CREATED

```bash theme={null}
coval personas list
```

## Get Persona

```bash theme={null}
coval personas get <persona_id>
```

| Argument     | Type   | Required | Description    |
| ------------ | ------ | -------- | -------------- |
| `persona_id` | string | **Yes**  | The persona ID |

```bash theme={null}
coval personas get per_abc123
```

## Create Persona

```bash theme={null}
coval personas create [OPTIONS]
```

| Option           | Type   | Required | Description                                   |
| ---------------- | ------ | -------- | --------------------------------------------- |
| `--name`         | string | **Yes**  | Persona display name                          |
| `--voice`        | string | **Yes**  | Voice name (see available voices below)       |
| `--language`     | string | **Yes**  | Language code (e.g., `en-US`)                 |
| `--prompt`       | string | No       | Persona system prompt / behavior instructions |
| `--background`   | string | No       | Background sound during simulation            |
| `--wait-seconds` | number | No       | Wait time between responses                   |

```bash theme={null}
# Create a basic persona
coval personas create \
  --name "Frustrated Customer" \
  --voice "Aria" \
  --language "en-US"

# Create with full configuration
coval personas create \
  --name "Impatient Caller" \
  --voice "Callum" \
  --language "en-US" \
  --prompt "You are an impatient customer who wants quick answers" \
  --background "office" \
  --wait-seconds 1.5
```

### Available Voices

Alejandro, Amir, Angela, Aria, Ashwin, Autumn, Brynn, Callum, Caspian, Corwin, Darrow, Delphine, Dorian, Elara, Erika, Harry, Kieran, Layla, Lysander, Marina, Mark, Monika, Naveen, Noa, Orion, Raju, Rowan, Skye, Soren, Vera, Yossi

## Update Persona

```bash theme={null}
coval personas update <persona_id> [OPTIONS]
```

| Argument     | Type   | Required | Description              |
| ------------ | ------ | -------- | ------------------------ |
| `persona_id` | string | **Yes**  | The persona ID to update |

| Option           | Type   | Description          |
| ---------------- | ------ | -------------------- |
| `--name`         | string | New display name     |
| `--voice`        | string | New voice name       |
| `--language`     | string | New language code    |
| `--prompt`       | string | New system prompt    |
| `--background`   | string | New background sound |
| `--wait-seconds` | number | New wait time        |

```bash theme={null}
coval personas update per_abc123 --voice "Brynn" --wait-seconds 2.0
```

## Delete Persona

```bash theme={null}
coval personas delete <persona_id>
```

| Argument     | Type   | Required | Description              |
| ------------ | ------ | -------- | ------------------------ |
| `persona_id` | string | **Yes**  | The persona ID to delete |