Permanently remove a job and its resources. For a running job, the training container is destroyed through the agent control channel first, then models, exports, billing records, events, and interventions are cleaned up.
Method + Path
Authentication
Include your PIN API token or JWT in the Authorization header as a Bearer token.
Path parameters
Id of the job to delete, e.g. jb_abc123def456.
Request example
Response
Returns a standard PIN success envelope confirming the deletion.
0 on success, nonzero on error.
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.