Cancel Run
cancel_runCancel an active pipeline run in Coalesce to stop execution immediately. Requires explicit user confirmation because data may be left inconsistent.
Instructions
Cancel an in-progress Coalesce run. Destructive — the run will be terminated immediately. Canceling a running pipeline mid-execution can leave data in an inconsistent state (partial loads, half-transformed tables). There is no 'undo cancel'.
Args:
runID (string, required): Numeric run ID to cancel
environmentID (string, required): Environment the run belongs to
orgID (string, optional): Organization ID. Falls back to COALESCE_ORG_ID env var or
orgIDin the active ~/.coa/config profile.confirmed (boolean, optional): Set to true after the user explicitly confirms cancellation
Returns: Confirmation with updated run status.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"runID": "<runID>",
"environmentID": "<environmentID>"
},
"name": "cancel_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgID | No | The organization ID. Optional if COALESCE_ORG_ID is set, or if `orgID` is present in the active ~/.coa/config profile. | |
| runID | Yes | The numeric run ID (integer) of the run to cancel | |
| confirmed | No | Set to true after the user explicitly confirms the cancellation. | |
| environmentID | Yes | The environment ID the run belongs to |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| runStatus | No | ||
| runCounter | No |