Runs

Rewind Run

Creates a new run from an earlier checkpoint of a terminal source run, archives the source run, and records run.superseded_by on the source after archive succeeds. Returns 207 when the new run was created but the source archive step failed.

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

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

archivedboolean required

archive_errorstring nullable

Changes

No recorded changes to this endpoint across all 134 revisions of this API.