Cancel a background Codex job
codex_job_cancelCancel a running Codex job by sending SIGTERM, then SIGKILL after a grace period. Provides clear reporting on whether this call successfully stopped the job.
Instructions
Stop a run that is still going: SIGTERM first, then SIGKILL after a grace period. Reports honestly whether this call is what cancelled it.
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": {
"job_id": "<job_id>"
},
"name": "codex_job_cancel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | Job id to cancel. Sends SIGTERM, then SIGKILL after a grace period. |