foliot docs

API reference / Runs / Go back to a step and re-run forward

Go back to a step and re-run forward

POST/apps/{appId}/runs/{runId}/rewind

Authenticate with an operator token or an app API key or a signed-in Foliot Console session.

Discards toStep’s output and that of every step which ran after it, then runs forward on a new generation. Works on FINISHED runs, which is what makes it the tool for a bad deploy. Optionally repins to another version.

Path parameters

appId
string
REQUIRED

The app's name.

runId
string (uuid)
REQUIRED

Request body

reason
string
OPTIONAL

max length 1000

toStep
string
REQUIRED

min length 1

version
integer (int64)
OPTIONAL

min 1 · max 2147483647

Responses

200 object OK
400 Error Invalid request.
401 Error Missing, malformed or unknown bearer token.
403 Error The token is valid but not permitted on this route.
404 Error No such resource.
409 Error Conflicts with existing state.
503 Error A dependency this route needs is unreachable.