Skip to main content

Cancel a Pending Job

This endpoint allows you to cancel a pending transcription job. Once canceled, the job cannot be resumed or retrieved.

Endpoint​

DELETE https://api.speechischeap.com/v1/jobs/:job_id

Authentication​

Requires authentication using a Bearer token in the HTTP header:

Authorization: Bearer YOUR_API_KEY

Example Request​

Using cURL​

curl --request DELETE \
     --url https://api.speechischeap.com/v1/jobs/00000000-1111-4222-3333-444444444444-u1 \
     --header 'Authorization: Bearer YOUR_API_KEY'

Response​

The API uses standard HTTP status codes to indicate the outcome of your request:

Status CodeDescription
200 OKJob was successfully canceled
401 UnauthorizedInvalid or missing authentication token
404 Not FoundJob not found, already completed, or already canceled
500 Internal Server ErrorServer-side error occurred

Success Response​

HTTP/1.1 200 OK
Content-Type: text/plain

OK

Error Response​

HTTP/1.1 500 Internal Server Error
Content-Type: text/plain

Error canceling job

Note​

  • Attempting to cancel completed or previously-canceled jobs will return 404 Not Found