Skip to main content

​
List Personas

coval personas list [OPTIONS]
OptionTypeDefaultDescription
--filterstring—Filter expression
--page-sizenumber50Results per page
--order-bystring—Sort order
Output columns: ID, NAME, VOICE, LANGUAGE, CREATED 
coval personas list

​
Get Persona

coval personas get <persona_id>
ArgumentTypeRequiredDescription
persona_idstringYesThe persona ID
coval personas get per_abc123

​
Create Persona

coval personas create [OPTIONS]
OptionTypeRequiredDescription
--namestringYesPersona display name
--voicestringYesVoice name (see available voices below)
--languagestringYesLanguage code (e.g., en-US)
--promptstringNoPersona system prompt / behavior instructions
--backgroundstringNoBackground sound during simulation
--wait-secondsnumberNoWait 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]
ArgumentTypeRequiredDescription
persona_idstringYesThe persona ID to update
OptionTypeDescription
--namestringNew display name
--voicestringNew voice name
--languagestringNew language code
--promptstringNew system prompt
--backgroundstringNew background sound
--wait-secondsnumberNew wait time
coval personas update per_abc123 --voice "Brynn" --wait-seconds 2.0

​
Delete Persona

coval personas delete <persona_id>
ArgumentTypeRequiredDescription
persona_idstringYesThe persona ID to delete