---
title: "Cancel job"
method: DELETE
path: "/jobs/{id}"
tags: ["Jobs"]
---

# Cancel job

`DELETE /jobs/{id}`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/jobs/{id}`
- Auth: API key in header `Authorization`

Cancels a queued or processing job. No credits are charged for cancelled jobs, so credits_refunded is always 0. Returns 409 if the job is already in a terminal state.

## Path parameters

- `id` string, required

## Response `200`

Job cancelled

- JobCancelResponse
  - `id` string, required
  - `object` 'job', required
  - `status` 'cancelled', required
  - `credits_refunded` integer, required

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `409`: Job is not cancellable
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)
