Rerun processing node

Requests to rerun the specified processing node. A successful request only means that the rerun has been created; please continue to query the associated jobs or products to confirm the final result.

HTTP

POST $CLOUDSIGMA_API_BASE/lineage/artifacts/{artifact_id}/nodes/{node_id}/rerun

Before you call this API

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

Request

Input examples

Shell

curl -X POST "$CLOUDSIGMA_API_BASE/lineage/artifacts/$ARTIFACT_ID/nodes/$NODE_ID/rerun" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "rerun_current_and_downstream"
  }'

Parameter reference

Request body

Field	Type	Description
mode	string	Rerun mode; when provided, it must be rerun_current_and_downstream.
config_override	object	Override node configuration.
input_payload_override	object	Override run input.
vars_payload_override	object	Override run variables.

Successful response

When the request is successful, the data of this operation is returned. Just because the write or run request has been accepted does not mean that the subsequent processing has been completed; please confirm the result based on the return status or subsequent query.

The response fields are as follows.

Response example

JSON

{
  "code": "OK",
  "msg": "OK",
  "data": {"artifact_id": "art-001", "node_id": "node-001", "rerun_id": "rerun-001", "status": "submitted"}
}

Field reference

Field	Type	Description
data.artifact_id	string	Product ID.
data.node_id	string	Node ID.
data.rerun_id	string	Rerun ID.
data.branch_id	string	New branch ID.
data.case_id	string	Processing case ID.
data.status	string	Rerun status.

Error response

Response example

JSON

{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

Field reference

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

Last updated on Sep 15, 2026