Skip to main content

Post Sagas Start

POST 

/v1/sagas/start

Start a saga from a registered definition; returns 202 with trace_id.

Creates saga and step instances in a transaction and emits SAGA_STARTED.

Args: body: Namespace, name, version, and input for the saga.

Returns: StartSagaResponse with trace_id.

Raises: HTTPException: 404 if definition not found; 409 on idempotency conflict or inactive catalog definition (structured INACTIVE_CATALOG_DEFINITION / CATALOG_DEFINITION_NOT_FOUND); 400 on other ValueError.

Request​

Responses​

Successful Response