Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Control the lifecycle of a training job through pause, resume, start, and stop transitions. Each action returns the updated job status.
POST /v1/jobs/:id/pause
POST /v1/jobs/:id/resume
POST /v1/jobs/:id/start
POST /v1/jobs/:id/stop
Authorization header as a Bearer token.
Authorization: Bearer <token>
jb_abc123def456).curl -s -X POST "https://api.ariacompute.com/v1/jobs/jb_abc123def456/pause" \
-H "Authorization: Bearer $PIN_API_TOKEN"
curl -s -X POST "https://api.ariacompute.com/v1/jobs/jb_abc123def456/resume" \
-H "Authorization: Bearer $PIN_API_TOKEN"
curl -s -X POST "https://api.ariacompute.com/v1/jobs/jb_abc123def456/start" \
-H "Authorization: Bearer $PIN_API_TOKEN"
curl -s -X POST "https://api.ariacompute.com/v1/jobs/jb_abc123def456/stop" \
-H "Authorization: Bearer $PIN_API_TOKEN"
0 on success, nonzero on error.{
"code": 0,
"data": {
"job_id": "jb_abc123def456",
"status": "paused"
},
"message": ""
}
| Action | Allowed from | Result | Notes |
|---|---|---|---|
pause | running | paused | GPU released, checkpoints kept. |
resume | paused | running or queued | Tries agent-local resume first; falls back to re-enqueue. |
start | queued, paused | running or queued | No-op if already running. For paused, acts as resume. |
stop | Any non-terminal | stopped | Terminal state; no refund. |
| Code | HTTP | Meaning |
|---|---|---|
| 401 | 401 | Missing or invalid Bearer token. |
| 404 | 404 | Job not found or does not belong to you. |
| 409 | 409 | Invalid state transition (e.g., pausing a non-running job). |
| 500 | 500 | Internal server error. |
Was this page helpful?