---
title: "Bulk-replay FAILED executions matching a filter"
method: POST
path: "/v1/replays"
---

# Bulk-replay FAILED executions matching a filter

`POST /v1/replays`

## Request

- Base URL: `https://api.klanexai.com`
- URL: `https://api.klanexai.com/v1/replays`
- Auth: API key in header `X-API-Key`

Outage recovery. TARGET_REJECTED and SCHEMA_INVALID failures are skipped unless include_rejected is true (their payloads would fail identically). Max 100 per call; repeat to drain more.

## Request body

- object
  - `since` string, date-time
  - `until` string, date-time
  - `limit` integer
  - `include_rejected` boolean

## Response `200`

Summary of the bulk operation.

- object
  - `replayed` integer
  - `skipped` integer
  - `enqueue_failed` integer
  - `executions` object[]
    - `execution_id` string
    - `replay_of` string

## Other responses

- `400`: Malformed request (bad URL, unsupported method, invalid JSON, bad filter).
- `401`: Missing or invalid X-API-Key.
- `429`: Per-tenant rate limit exceeded; retry after Retry-After seconds.

---

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