---
title: "CreateReplay"
method: POST
path: "/v1.1/retl/replay"
tags: ["ControlService"]
---

# CreateReplay

`POST /v1.1/retl/replay`

Submits a data replay job; response carries run_id and workflow_name.

## Request body

- ProtobufControlpbV1CreateReplayRequest
  - `config` union
    - object, nullable
    - ProtobufRetlpbV1ReplayConfig
      - `author` string
      - `createdAt` string, date-time, nullable
      - `id` string — User-provided identifier for this config (alphanumeric, _, -)
      - `secretRef` string
      - `sourceConfig` union — Where to read events from and how to filter them.
        - object, nullable
        - ProtobufRetlpbV1SourceConfig
          - `globPattern` string — Glob pattern for file discovery (e.g. events/**/*.json.gz)
          - `scopes` union — Filtering criteria. Events that match scopes are pass into to the system for ingestion. E.g. Ingest only page events within last 30 days.
            - object, nullable
            - ProtobufRetlpbV1Scopes
              - …
          - `source` union
            - object, nullable
            - ProtobufRetlpbV1ObjectStorage
              - …

## Response `200`

OK

- ProtobufControlpbV1CreateReplayResponse
  - `config` union
    - object, nullable
    - ProtobufRetlpbV1ReplayConfig
      - `author` string
      - `createdAt` string, date-time, nullable
      - `id` string — User-provided identifier for this config (alphanumeric, _, -)
      - `secretRef` string
      - `sourceConfig` union — Where to read events from and how to filter them.
        - object, nullable
        - ProtobufRetlpbV1SourceConfig
          - `globPattern` string — Glob pattern for file discovery (e.g. events/**/*.json.gz)
          - `scopes` union — Filtering criteria. Events that match scopes are pass into to the system for ingestion. E.g. Ingest only page events within last 30 days.
            - object, nullable
            - ProtobufRetlpbV1Scopes
              - …
          - `source` union
            - object, nullable
            - ProtobufRetlpbV1ObjectStorage
              - …
  - `runId` string
  - `workflowName` string

## Other responses

- `4XX` — Something is wrong with your request such as missing or invalid data. Correct your request and try again.
- `5XX` — Internal server error. Try again later or reach out to MetaRouter support.

---

[API](https://skmtc.net/metarouter/apis/control-api.md) · [All operations](https://skmtc.net/metarouter/apis/control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metarouter/control-api/versions/5afc05bfaaa2/schema)