Terminate a training job - Fastino API Docs

POST

https://api.fastino.ai

training

jobs

{job_id}

terminate

curl -X POST https://api.fastino.ai/v1/training/jobs/YOUR_TRAINING_JOB_ID/terminate \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delete_checkpoints": false}'

{
  "success": true,
  "message": "Training job terminated. Checkpoints preserved (pass delete_checkpoints=true to remove them).",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "terminated"
}

{
  "success": true,
  "message": "Termination in progress. The job moves to 'terminated' once the provider confirms; checkpoints are preserved.",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "stopping"
}

POST /v1/training/jobs/{job_id}/terminate This operation is config-only; after normal feature and permission checks, an interactive job ID returns 400, so stop an interactive job with POST /v1/training/jobs/{job_id}/stop instead. Stops an active config job and requests provider cancellation. Existing checkpoints and artifacts are preserved by default.

Setting delete_checkpoints to true permanently deletes the job’s checkpoints and artifacts after cancellation is confirmed. This cannot be undone.

Request

string

required

Your Fastino API key.

string

required

Training-job UUID.

The JSON body is optional.

boolean

default:"false"

Permanently delete checkpoints and artifacts after cancellation is confirmed.

curl -X POST https://api.fastino.ai/v1/training/jobs/YOUR_TRAINING_JOB_ID/terminate \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delete_checkpoints": false}'

Response

{
  "success": true,
  "message": "Training job terminated. Checkpoints preserved (pass delete_checkpoints=true to remove them).",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "terminated"
}

{
  "success": true,
  "message": "Termination in progress. The job moves to 'terminated' once the provider confirms; checkpoints are preserved.",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "stopping"
}

Poll GET /v1/training/jobs/{job_id} after a 202; do not repeat the termination request while cancellation is pending.

Status	Meaning
`200`	The job is terminated.
`202`	Termination is in progress while the provider confirms cancellation.
`400`	`job_id` is not a valid config-job UUID, or it identifies an interactive job; use the interactive stop route instead.
`409 training_job_already_finished`	The job reached a terminal state before termination.
`409 cancellation_unconfirmed`	Cancellation was not confirmed and may be retried.
`422`	The JSON request body is invalid.

Authorization

Requires the Owner, Admin, or Editor team role. Other roles receive 403 Forbidden.

curl -X POST https://api.fastino.ai/v1/training/jobs/YOUR_TRAINING_JOB_ID/terminate \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delete_checkpoints": false}'

{
  "success": true,
  "message": "Training job terminated. Checkpoints preserved (pass delete_checkpoints=true to remove them).",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "terminated"
}

{
  "success": true,
  "message": "Termination in progress. The job moves to 'terminated' once the provider confirms; checkpoints are preserved.",
  "job_id": "YOUR_TRAINING_JOB_ID",
  "deleted_checkpoints": 0,
  "status": "stopping"
}

​Request

​Response

​Authorization

Request

Response

Authorization