Skip to main content
POST
/
v1
/
simulations
/
{simulation_id}
/
resimulate
Rerun a simulation
curl --request POST \
  --url https://api.coval.dev/v1/simulations/{simulation_id}/resimulate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'
{
  "simulation_id": "4bgnvEcWRtj5HbtfEujWdT",
  "run_id": "3zfmuDbVQsi4GaseDtiVcS",
  "queued": true,
  "message": "Simulation rerun queued. The latest database-backed versions of the agent, persona, test set, test case, metrics, and mutation config will be reloaded before execution, and the current simulation result will be overwritten."
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication.

Path Parameters

​
simulation_id
string
required

The simulation ID to rerun

Required string length: 22 - 27

Body

application/json

Request body for resimulating a simulation. Currently no user-facing fields; the body may be empty or omitted.

Response

Simulation rerun was accepted and queued

​
simulation_id
string
required

The simulation that was queued for rerun

Example:

"4bgnvEcWRtj5HbtfEujWdT"

​
run_id
string
required

The parent run that owns the simulation

Example:

"3zfmuDbVQsi4GaseDtiVcS"

​
queued
boolean
required

Whether the resimulation job was queued successfully

Example:

true

​
message
string
required

Human-readable summary of rerun behavior

Example:

"Simulation rerun queued. The latest database-backed versions of the agent, persona, test set, test case, metrics, and mutation config will be reloaded before execution, and the current simulation result will be overwritten."