Documentation Index
Fetch the complete documentation index at: https://docs.coval.dev/llms.txt
Use this file to discover all available pages before exploring further.
List Personas
coval personas list [OPTIONS]
| Option | Type | Default | Description |
|---|
--filter | string | — | Filter expression |
--page-size | number | 50 | Results per page |
--order-by | string | — | Sort order |
Get Persona
coval personas get <persona_id>
| Argument | Type | Required | Description |
|---|
persona_id | string | Yes | The persona ID |
coval personas get per_abc123
Create Persona
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 |
# 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
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 |
coval personas update per_abc123 --voice "Brynn" --wait-seconds 2.0
Delete Persona
coval personas delete <persona_id>
| Argument | Type | Required | Description |
|---|
persona_id | string | Yes | The persona ID to delete |
