Simulated Conversations

List Simulated Conversations

coval simulated-conversations list [OPTIONS]

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

Output columns: ID, STATUS, RUN, TEST CASE, AUDIO

# List all simulated conversations
coval simulated-conversations list

# Filter by run
coval simulated-conversations list --run-id run_abc123

# Combine filters
coval simulated-conversations list --filter 'status="COMPLETED"' --run-id run_abc123

Get Simulated Conversation

coval simulated-conversations get <simulation_id>

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID

Returns full simulation details as JSON including transcript, status, and metadata.

coval simulated-conversations get sim_abc123

Update Simulated Conversation

Add reviewer notes to a simulated conversation or mark it as public.

coval simulated-conversations update <simulation_id> [OPTIONS]

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID to update

Option	Type	Description
`--notes`	string	Free-text notes to store on the conversation
`--is-public`	flag	Mark the conversation as public. Omitting the flag leaves the current value unchanged; the CLI cannot set it back to private

# Attach notes
coval simulated-conversations update sim_abc123 --notes "Agent skipped the recording disclosure"

# Make the conversation public
coval simulated-conversations update sim_abc123 --is-public

Resimulate

Requeue a single simulated conversation to run again in place. The rerun uses the agent’s current configuration while keeping the persona prompt and test case parameters recorded on the original run, and its result overwrites the currently visible result for this conversation when it completes.

coval simulated-conversations resimulate <simulation_id> [OPTIONS]

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID to rerun

Option	Type	Description
`--dev-id`	string	Optional developer identifier for debugging

coval simulated-conversations resimulate sim_abc123

Download Audio

Download or get the audio URL for a simulation recording.

coval simulated-conversations audio <simulation_id> [OPTIONS]

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID

Option	Type	Description
`-o, --output`	string	File path to save audio

# Print audio URL
coval simulated-conversations audio sim_abc123

# Download audio file
coval simulated-conversations audio sim_abc123 -o recording.wav

When using -o, a progress bar shows the download status.

List Metrics

List the current metric results for a simulated conversation. If a metric has been re-scored, only its most recent result is listed.

coval simulated-conversations metrics <simulation_id>

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID

Output columns: OUTPUT ID, METRIC ID, STATUS, VALUE, SUBVALUES

coval simulated-conversations metrics sim_abc123

Get Metric Detail

Retrieve metric results for a simulation. The second argument accepts two ID types and the output adapts accordingly:

26-char MetricOutput ULID — prints one row (the specific output).
22-char Metric definition ID — prints every output recorded for that metric on the simulation.

coval simulated-conversations metric-detail <simulation_id> <id>

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID
`id`	string	Yes	Either a 26-char MetricOutput ULID or a 22-char Metric definition ID

By MetricOutput ULID (one row):

coval simulated-conversations metric-detail sim_abc123 01ARZ3NDEKTSV4RRFFQ69G5FAV

By Metric definition ID (one or more rows):

coval simulated-conversations metric-detail sim_abc123 29BlkepvvX19ebbLDB0y6Q

Delete Simulation

coval simulated-conversations delete <simulation_id>

Argument	Type	Required	Description
`simulation_id`	string	Yes	The simulation ID to delete

Simulation Statuses

Status	Description
`PENDING`	Simulation is created but not yet started
`IN_QUEUE`	Simulation is queued for execution
`IN_PROGRESS`	Simulation is actively running
`COMPLETED`	Simulation finished successfully
`FAILED`	Simulation encountered an error
`CANCELLED`	Simulation was cancelled
`DELETED`	Simulation was deleted

When using --filter, use the underscore-separated enum values (e.g., status="IN_PROGRESS").

Getting Started

Resources

List Simulated Conversations

Get Simulated Conversation

Update Simulated Conversation

Resimulate

Download Audio

List Metrics

Get Metric Detail

Delete Simulation

Simulation Statuses

​List Simulated Conversations

​Get Simulated Conversation

​Update Simulated Conversation

​Resimulate

​Download Audio

​List Metrics

​Get Metric Detail

​Delete Simulation

​Simulation Statuses

List Simulated Conversations

Get Simulated Conversation

Update Simulated Conversation

Resimulate

Download Audio

List Metrics

Get Metric Detail

Delete Simulation

Simulation Statuses