sangtao.ai
API key

Jobs

Delete a job

Delete a job and its result files, for good.

DELETEhttps://api.sangtao.ai/v2/jobs/{jobId}

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

Path parameters

  • jobIdstringrequired

    The jobId in the path.

Deleting removes the job and its result files (images, videos) for good — their URLs stop working. It cannot be undone.

Key access

The API key needs Write access to Jobs. A read-only key gets 403.

Errors

StatuserrorCodeWhen
403FORBIDDENThe key has no Write access to Jobs
404JOB_NOT_FOUNDNo job of yours with this jobId
409JOB_PUBLISHEDThe job is public in the gallery — take it down first
DELETE/jobs/{jobId}
curl -X DELETE "https://api.sangtao.ai/v2/jobs/img-456" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "deleted": 1
  }
}