Skip to main content
GET
Preview a retry of a failed workflow run

Authorizations

Authorization
string
header
required

All requests to the Cortex API need to provide an Authorization: Bearer <token> header, where <token> is an API key created in the Settings page of your workspace.

Path Parameters

tagOrId
string
required

The tag or unique, auto-generated identifier for the workflow. Entity identifier - can be a tag or CID

runId
string
required

The ID of the failed run

Query Parameters

fromSlug
string

The action to start the retry from. Defaults to the failed action. To start in a child run, use <Run Workflow action slug>/<child action slug>.

Response

The retry plan, or why the run cannot be retried

retryable
boolean
required

True when the run can be retried. Then plan and planVersion are set.

plan
object

The actions that the retry runs

planVersion
string

Identifies this plan. Send it to the retry endpoint, which refuses the retry with PLAN_CHANGED when the plan is different.

refusal
object

Why the run cannot be retried. Set only when retryable is false.