> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sutro.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Cancel a job

> Request cancellation of an active Batch job.

<ParamField path="job_id" type="string" required>The job to cancel.</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>
  Deployment API key in the form `Key YOUR_SUTRO_API_KEY`.
</ParamField>

```bash theme={null}
curl https://YOUR-SUTRO-DEPLOYMENT/v1/job-cancel/JOB_ID \
  -H "Authorization: Key YOUR_SUTRO_API_KEY"
```

```json theme={null}
{
  "cancelled": true,
  "message": "Cancelling job with job_id: JOB_ID. Check the job status endpoint for details."
}
```

Cancellation is asynchronous. A successful request moves the job to
`CANCELLING`; monitor [job status](/reference/api/job-status) until it reaches
`CANCELLED` or another terminal state. Only request cancellation for an active
job; the endpoint currently accepts any existing job and does not reject jobs
that are already terminal. A missing job returns `404` with a `detail` message.