Cancel an assessment run
cancel_runAsk a running assessment to stop -- the counterpart to trigger_assessment, for a run you started against the wrong target or no longer need. The run stops within about five seconds and keeps the findings and probes it already produced, so its results are still worth reading. Returns immediately: poll get_assessment_status until the status leaves 'running'. A run that has already finished is a conflict, not a retryable error. Requires the test:run scope, the same authority as starting one. Treating a cancelled run as a clean bill of health is a mistake: get_assessment_status still returns a min_severity verdict for it, but that verdict only covers the categories in categories_completed, so a run stopped early reads 'pass' simply because it never got far enough to find anything.
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": {
"run_id": "<run_id>"
},
"name": "cancel_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | Yes | ||
| status | Yes | The run's status immediately after the request: 'running' while it winds down (it stops within about five seconds -- poll get_assessment_status), or 'cancelled' when it had already died and was settled by this call. Either way the run keeps the findings and probes it produced before the stop, so its results are still worth reading. |