Cancel or delete a transcription job

DELETE/v1/transcriptions/{job_id}0 credits

Cancels a queued or running job (its reserved credits are returned and the uploaded file deleted) or deletes a finished job together with its result.

01Query parameters

Name	Type	Description
job_idrequired	string	The job id from `POST /v1/transcriptions` (32 hex characters).

02Pricing

Free.

03Request

curl -X DELETE "https://api.scrapesocial.ai/v1/transcriptions/3f2a9c1e5b7d40a8b6c2e9f1a4d7b0c3" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Responses

Real answers from the API. Lists are shortened to 2 items.

DELETE /v1/transcriptions/8c51b6ab208c0f4c5fc98ea6740595a6

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "job_id": "8c51b6ab208c0f4c5fc98ea6740595a6",
  "status": "deleted",
  "credits_refunded": 0
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

05Notes

Answer: `job_id`, `status` (`cancelled` or `deleted`) and `credits_refunded` (the reservation for a cancelled job, 0 for a deleted one: a completed job's charge stays). Another account's job is a 404.

06Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.