Docs · DELETE /job/{jobId}
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
jobIdstringThe job’s id.

Request body

This request has no body.

Example

Request
curl -X DELETE https://media.logicboostkit.com/job/job_0mv6ihz6vfx5ua0h05x8bmql \
  -H "Authorization: Basic $MEDIA_KEY"
Response
HTTP/1.1 200 OK
X-Request-Id: job_0mv6io8lccjzfdcme0rft6oj

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

Response fields

Response fields
okbooleantrue when the job was cancelled.
messagestring“Job cancelled successfully”.

Status codes

Status codes
200The job is cancelled. Not charged.
401The Authorization header is missing, or the key is invalid, revoked or expired.
403The account isn’t active. The error says what to do.
404Job not found: the job isn’t in your account, or it went when its directory was deleted.
409The job is no longer pending: Cannot cancel job in 'processing' status. Only pending jobs can be cancelled.
429More 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.