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, Angela, Aria, Ashwin, Autumn, Brynn, Callum, Caspian, Corwin, Darrow, Delphine, Dorian, Elara, Erika, Harry, Kieran, Lysander, Marina, Mark, Monika, Naveen, Orion, Raju, Rowan, Skye, Soren, Vera

​
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