Hard Delete Job

Permanently remove a job's media file, result data, or both. Unlike the soft delete, this is irreversible.

DELETE /v1/jobs/{job_id}/hard

Authentication

• Authentication is required. Include a valid df_ API key in the Authorization header, or rely on the machine-local default credential. See Authentication.

---

Path Parameters

Parameter	Type	Description
job_id	number(int)	The edge job id to hard-delete.

---

Request Body

Parameter	Type	Description	Required
delete_type	string	What to remove: "file", "data", or "full".	Yes

delete_type	Effect
file	Deletes the source media file and the job's upload directory. Result rows and the job record are kept.
data	Deletes all stored per-model result rows. The media file and job record are kept.
full	Deletes the media file, all result rows, and the job record itself.

{
  "delete_type": "full"
}

---

Response

{
  "status": true,
  "code": 200,
  "message": "Job hard delete completed",
  "data": {
    "job_id": 42,
    "delete_type": "full"
  }
}

---

Errors

Code	Condition
404	No job exists with the given id.
422	delete_type is not one of file, data, or full.

---

Example Request

curl -X DELETE http://<edge-host>:9123/v1/jobs/42/hard \
  -H "Authorization: Bearer df_..." \
  -H "Content-Type: application/json" \
  -d '{"delete_type": "full"}'