Runs

Rewind Run

Changed on

Creates a new run from a checkpoint of a terminal source run and starts it, then archives the source run and records run.superseded_by on it. Returns 207 when the new run was created but the source archive step failed. Requires a GitHub target with run-branch creation and pushes enabled. The checkpoint must leave work to execute: the final terminal checkpoint is refused; select an earlier checkpoint or retry the workflow from the beginning.

post/api/v1/runs/{id}/rewind

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

Path parameters

idstring required

Unique run identifier (ULID).

Request body

targetstring nullable

Optional checkpoint target such as @2, build, or build@1. Defaults to the latest checkpoint.

Response

Source archived and new run created

source_run_idstring required
new_run_idstring required
targetstring required

The checkpoint the rewind was resolved to, as @ordinal.

checkpoint_shastring required
executioninteger required
firinginteger required
archivedboolean required
archive_errorstring nullable

Changes