---
search:
  tags:
    - Jobs
    - POST
seo:
  description: >-
    Cancels a job that has not finished and releases its 1-cent reservation.
    Cancelling a… Reference for the POST /v1/jobs/{id}/cancel endpoint in the
    convt API.
sidebar:
  label: Cancel a job
  badge: POST
title: Cancel a job
type: openapi-operation
---
Cancels a job that has not finished and releases its 1-cent reservation. Cancelling a finished job changes nothing and returns it as it is, so check `status` in the response: `succeeded` means the job finished first and was billed.

The uploaded file still counts toward your storage limit until the job expires 24 hours after creation.

`POST /v1/jobs/{id}/cancel`

**Responses**

- `200` — The job after cancellation.
- `400` — Request refused
- `401` — \`unauthorized\`: no \`Authorization: Bearer\` header.
- `403` — \`unauthorized\` (key invalid or revoked) or a billing limit.
- `404` — \`not\_found\`: the job does not exist, belongs to another account, or has expired.
- `429` — \`rate\_limited\`: more than 120 requests in a minute for this key.
- `502` — \`storage\_unavailable\`: object storage did not answer. Retry with backoff.

Response example, 200:

```json
{
  "id": "string",
  "status": "created",
  "input_format": "string",
  "target_format": "string",
  "input_bytes": 0,
  "attempt": 0,
  "error_code": "string",
  "expires_at": "2019-08-24T14:15:22Z"
}
```