---
title: "Queue a child run over this run's failed cases"
method: POST
path: "/v1/agents/{agent_id}/simulation-suite-runs/{run_id}/rerun-failed"
---

# Queue a child run over this run's failed cases

`POST /v1/agents/{agent_id}/simulation-suite-runs/{run_id}/rerun-failed`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/agents/{agent_id}/simulation-suite-runs/{run_id}/rerun-failed`
- Auth: none declared

The child reuses the parent's pinned suite revision, content hash and compiled workflow, so it asks exactly the question the original asked. The parent run and every verdict it holds are left untouched.

## Path parameters

- `agent_id` string, required
- `run_id` string, required

## Request body

- object
  - `idempotency_key` string, required

## Response `202`

Durable queued child run

## Other responses

- `400`: Missing idempotency_key
- `404`: Run not found, or Simulations Lab is not enabled
- `409`: The idempotency key was already used for a different request
- `422`: Typed refusal: no_failed_cases, unsupported_mode, active_run_limit or organization_budget

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)
