---
title: "Replay Tracerfy Start"
method: POST
path: "/api/v1/admin/replay-tracerfy"
tags: ["admin"]
---

# Replay Tracerfy Start

`POST /api/v1/admin/replay-tracerfy`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/admin/replay-tracerfy`
- Auth: API key in header `X-API-Key`

Launch a replay job and return immediately.

The work runs in the background; the report lands in S3 at
`s3://<bucket>/enrichment/_replay/tracerfy/reports/<report_id>.json`.
Poll `GET /admin/replay-tracerfy/{report_id}` for completion.

## Request body

- ReplayTracerfyRequest
  - `queue_ids` integer[], required
  - `states` string[], nullable: States to load into the matcher index. Defaults to all live states (the pipeline.config registry).
  - `dry_run` boolean: When True, parse + match but don't commit any writes

## Response `202`

Successful Response

- ReplayTracerfyAccepted
  - `report_id` string, required
  - `status_url` string, required
  - `state` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)