cancel
Stop active Codex delegate runs by delegation ID, thread ID, or all at once, and wait for settlement. Returns cancelled, nothing-active, or not-found status.
Instructions
Cancel active runs. delegationId selects one (announced in progress before spawn — the only handle if a run wedges at startup), threadId all on its thread, neither all. Waits for settlement; if a process tree survives the kill deadline, it still returns and the delegate result warns. Status: cancelled, nothing-active, or not-found (no active run with this ID).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| threadId | No | ||
| delegationId | No |