---
title: "Rerun Simulation Results"
method: POST
path: "/v1/rerun-simulation-results"
tags: ["Rerun Simulation Results"]
---

# Rerun Simulation Results

`POST /v1/rerun-simulation-results`

Rerun an explicit list of test_results in their existing simulation run.

Resolves the run from the provided test_result_ids (which must all share one
simulation and one run), then defers to create_same_run_reruns for eligibility,
the retry cap, idempotency, and the org rerun settings.

Auth: standard API key / JWT, or X-Webhook-Secret (LiveKit agent / eval). When
using webhook secret, the org is derived from the simulation itself.

## Headers

- `X-Webhook-Secret` string, nullable
- `X-API-Key` string, required

## Request body

- RerunSimulationResultsRequest
  - `simulation_id` string, required — ID of the simulation the test_results belong to
  - `test_result_ids` integer[], required — IDs of existing test_results to rerun in their same simulation run.
  - `force` boolean — When True, bypass the simulation's rerun settings gates (enable_rerun_failed_test_results / enable_rerun_on_custom_error). Structural checks (retry cap, idempotency) still apply. Use for manual UI-triggered reruns.

## Response `200`

Successful Response

- RerunSimulationResultsResponse
  - `simulation_run_id` string, required — ID of the existing simulation run the reruns were added to
  - `simulation_result_ids` string[], required — IDs of the newly created rerun test_results
  - `agent_id` string, required — ID of the agent associated with the simulation run
  - `status` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/f48cef80963f/schema)