Skip to main content
Use this endpoint to permanently remove a job and all associated resources. For running jobs, the system first destroys the training container through the agent control channel, then cascades cleanup of models, exports, billing records, events, and interventions.

​
Method + Path

​
Authentication

Include your PIN API token or JWT in the Authorization header as a Bearer token.

​
Path parameters

​
string
required
The job identifier to delete (e.g., jb_abc123def456).

​
Request example

​
Response

Returns a standard PIN success envelope confirming the deletion.
​
integer
required
0 on success, nonzero on error.
​
object
required
​
string
Human-readable message (empty on success).

​
Example response

​
Errors

​
Notes

  • Deletion is permanent and cannot be undone.
  • If the agent control channel times out while stopping a running job, the cascade still proceeds but the error is recorded on the job row.
  • For queued or running jobs, prefer POST /v1/jobs/:id/cancel if you only want to stop training without removing artifacts.