Reference · Jobs

# DELETE/job/{jobId}

Cancels a job that is still pending. A job that has started can’t be cancelled. A cancelled job is never charged and sends no webhook.

## Parameters

Parameters

- `jobId` (string): The job’s id.

## Request body

This request has no body.

## Example

Request

```bash
curl -X DELETE https://media.logicboostkit.com/job/job_0mv6ihz6vfx5ua0h05x8bmql \
  -H "Authorization: Basic $MEDIA_KEY"
```

Response

```http
HTTP/1.1 200 OK
X-Request-Id: job_0mv6io8lccjzfdcme0rft6oj

{
  "ok": true,
  "message": "Job cancelled successfully"
}
```

## Response fields

Response fields

- `ok` (boolean): true when the job was cancelled.
- `message` (string): “Job cancelled successfully”.

## Status codes

Status codes

- **200**: The job is cancelled. Not charged.
- **401**: The `Authorization` header is missing, or the key is invalid, revoked or expired.
- **403**: The account isn’t active. The error says what to do.
- **404**: `Job not found`: the job isn’t in your account, or it went when its directory was deleted.
- **409**: The job is no longer pending: `Cannot cancel job in 'processing' status. Only pending jobs can be cancelled.`
- **429**: More than 300 requests in a minute on this key. Wait for the number of seconds in `Retry-After`.

Every error has the shape `{"ok": false, "error": "…"}` and is never charged.