> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete or cancel a training job

> Delete a training job and cascade its models, exports, events, and billing. For running jobs, the container is destroyed first.

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

```http theme={null}
DELETE /v1/jobs/:id
```

## Authentication

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

```http theme={null}
Authorization: Bearer <token>
```

## Path parameters

<ParamField path="id" type="string" required>
  The job identifier to delete (e.g., `jb_abc123def456`).
</ParamField>

## Request example

<CodeGroup>
  ```bash curl theme={null}
  curl -s -X DELETE "https://api.ariacompute.com/v1/jobs/jb_abc123def456" \
    -H "Authorization: Bearer $PIN_API_TOKEN"
  ```
</CodeGroup>

## Response

Returns a standard PIN success envelope confirming the deletion.

<ResponseField name="code" type="integer" required>
  `0` on success, nonzero on error.
</ResponseField>

<ResponseField name="data" type="object" required>
  <Expandable title="properties">
    <ResponseField name="job_id" type="string">
      The deleted job identifier.
    </ResponseField>

    <ResponseField name="deleted" type="boolean">
      Always `true` on success.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable message (empty on success).
</ResponseField>

### Example response

```json theme={null}
{
  "code": 0,
  "data": {
    "job_id": "jb_abc123def456",
    "deleted": true
  },
  "message": ""
}
```

## Errors

| Code | HTTP | Meaning                                  |
| ---- | ---- | ---------------------------------------- |
| 401  | 401  | Missing or invalid Bearer token.         |
| 404  | 404  | Job not found or does not belong to you. |
| 500  | 500  | Internal server error.                   |

## 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.


## Related topics

- [Delete an Agent](/api-reference/pin/agents/delete.md)
- [Delete a GPU Node](/api-reference/pin/gpu-nodes/delete.md)
- [Manually intervene in a running training job](/api-reference/pin/jobs/intervene.md)
- [Create Training Job with PIN API](/api-reference/pin/jobs/create.md)
- [Pause, resume, start, or stop a training job](/api-reference/pin/jobs/lifecycle.md)