Skip to content

Replay Execution

POST
/api/v1/executions/{execution_id}/replay

Replay a previous pipeline execution.

Full replay coordinator:

  1. Creates a new execution record linked to the parent
  2. Starts routes via OrchestratorManager (skip init_message)
  3. Publishes replay messages from source storage to target route

For cross-pipeline replay, provide config_id in the request body to use a different pipeline’s routes. Storage reads from the parent execution.

Args: execution_id: Parent execution UUID or tag to replay from request: Replay request with from_stage, to_route, and replay source service: Execution service (injected) container: Service container for manager, storage, queue, route resolver

Returns: New execution record for the replay

Raises: HTTPException: 404 if parent execution not found, 400 if route/stage invalid, 503 if services unavailable

execution_id
required
Execution Id
string
ExecutionReplayRequest

Request to replay a pipeline execution.

The execution to replay is identified by the execution_id path parameter. Server creates a new execution, starts routes, and publishes replay messages.

For cross-pipeline replay, provide config_id to use a different pipeline’s routes instead of the parent’s. Storage reads from the parent execution.

object
replay_source
required
Replay Source

Type of replay

string
Allowed values: storage lineage manual
from_stage
required
From Stage

Pipeline stage to replay from (e.g. ‘markdown_segmented’)

string
>= 1 characters
to_route
required
To Route

Target route name (e.g. ‘embedding_generator’)

string
>= 1 characters
from_path
Any of:
string
metadata
Any of:
object
key
additional properties
any
tag
Any of:
string
config_id
Any of:
string format: uuid

Successful Response

ExecutionResponse

Pipeline execution response.

Storage paths use execution id (UUID v7) directly.

object
id
required
Id

Execution UUID (used for storage paths)

string format: uuid
config_id
required
Config Id

Configuration ID

string format: uuid
status
required
Status

Current status

string
Allowed values: running completed failed cancelled interrupted
started_at
required
Started At

Start timestamp

string format: date-time
completed_at
Any of:
string format: date-time
parent_execution_id
Any of:
string format: uuid
replay_source
Any of:
string
Allowed values: storage lineage manual
tag
Any of:
string

Resource not found

ErrorResponse

Standard error response matching FastAPI HTTPException format.

This model is used in OpenAPI response declarations for 4xx/5xx errors. The detail field matches FastAPI’s HTTPException structure.

object
detail
required
Detail

Error message (matches FastAPI HTTPException)

string
error_code
Any of:
string
correlation_id
Any of:
string
timestamp
Timestamp

Error timestamp

string format: date-time

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object