Rerun from specified node¶

Creates a rerun branch from the specified node where the job has been executed. Successful creation does not mean that the branch is completed; please check the re-run details to confirm the status.

HTTP
POST $CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/{workflow_id}/executions/{execution_id}/nodes/{node_key}/reruns

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

First View node rerun plan, and save its rerun_contract_hash and node execution ID if needed.

Request¶

Input examples

Shell
curl -X POST "$CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/$EXECUTION_ID/nodes/$NODE_KEY/reruns" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H 'Content-Type: application/json' \
  -d '{
    "mode": "continue_from_node",
    "expected_rerun_contract_hash": "'"$RERUN_CONTRACT_HASH"'"
  }'

Parameter reference

Request body

Field	Type	Description
`workflow_id`	string	Workflow ID.
`execution_id`	string	Source job ID.
`node_key`	string	The node key to start the rerun from.
`mode`	string	Rerun mode; must be taken from planned `available_modes`.
`source_node_execution_id`	string	The selected source node execution ID.
`expected_rerun_contract_hash`	string	The contract hash returned by the plan, used to avoid using expired plans.
`values`	object	Runtime input override value.
`config_override`	object	Node configuration override value.
`reason`	string	Reason for rerun.

Successful response¶

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "rerun": {
      "rerun_id": "rerun-001",
      "branch_id": "branch-001",
      "case_id": "case-001",
      "source_execution_id": "exec-001",
      "node_key": "root.load",
      "source_node_execution_id": "node-exec-001",
      "mode": "continue_from_node",
      "status": "running"
    }
  }
}

Field reference

Field	Type	Description
`code`	string	`OK` when successful.
`msg`	string	`OK` when successful.
`data.rerun.rerun_id`	string	Rerun ID.
`data.rerun.branch_id`	string	New branch ID.
`data.rerun.case_id`	string	The case ID of the new branch.
`data.rerun.source_execution_id`	string	Source job ID.
`data.rerun.node_key`	string	The node key of the rerun starting point.
`data.rerun.source_node_execution_id`	string	Source node execution ID.
`data.rerun.mode`	string	The actual rerun mode used.
`data.rerun.status`	string	New branch status.
`data.start_error`	string	Error message when starting; only returned if there is a value.
`data.refresh_error`	string	Error message when refreshing; only returned if there is a value.

Error response¶

Response example

JSON
{
  "code": "contract_drift_detected",
  "msg": "重新运行计划已变化",
  "data": null
}

Field reference

Field	Type	Description
`code`	string	Error code.
`msg`	string	Readable error message.
`data`	null	`null` in an error response.

Follow-up operations¶

View workflow rerun details confirms branch status.

Last updated on Sep 15, 2026