Start New Run

Start a new simulation run for a dataset.

POST /api/v1/simulation/datasets/{dataset_id}/runs

Start New Run

cURL

curl --request POST \
  --url https://{tenant_id}.api.useago.com/api/v1/simulation/datasets/{dataset_id}/runs \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "<string>"
}
'

201

{
  "id": "<string>",
  "status": "<string>",
  "object": "simulation_run",
  "dataset_id": "<string>",
  "dataset_name": "<string>",
  "agent_id": "<string>",
  "agent_name": "<string>",
  "total_tests": 0,
  "passed_tests": 0,
  "failed_tests": 0,
  "success_rate": 123,
  "error_message": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>"
}

Authorizations

X-API-Key · string · header · required

Path Parameters

dataset_id · string · required

Body

application/json

Schema for starting a simulation run via the v1 API.

agent_id · string · required

Response

201 - application/json

Created

Response schema for simulation runs.

id · string · required

status · string · required

object · string · default: simulation_run

dataset_id · string | null

dataset_name · string | null

agent_id · string | null

agent_name · string | null

total_tests · integer · default: 0

passed_tests · integer · default: 0

failed_tests · integer · default: 0

success_rate · number | null

error_message · string | null

started_at · string | null

completed_at · string | null