foliot docs

API reference / Runs / Try again from the current step

Try again from the current step

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

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

Runs the step again on a NEW generation, so a handler that stores results by idempotency key executes fresh instead of replaying. State is kept — that is the difference from rewind. Refused on a succeeded or cancelled run.

Path parameters

appId
string
REQUIRED

The app's name.

runId
string (uuid)
REQUIRED

Request body

fromStep
string
OPTIONAL

Defaults to the run's current step.

reason
string
OPTIONAL

max length 1000

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.