Skip to main content

Cancel a Pending Job

This endpoint allows you to cancel a pending transcription job.

Endpoint​

DELETE https://api.speechischeap.com/v2/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/v2/jobs/00000000-1111-7222-b333-444444444444-sic \
     --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
402 Payment RequiredMissing subscription
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

Internal Server Error

Note​

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