Skip to main content
PUT
/
fine-tune
/
jobs
/
{job_id}
/
stop
curl -X PUT https://api.u1.archetypeai.app/v0.5/fine-tune/jobs/ftj-my-finetune-run-3de60a5c/stop \
  -H "Authorization: Bearer $ATAI_API_KEY"
{
  "name": "my-finetune-run",
  "id": "ftj-my-finetune-run-3de60a5c",
  "uuid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c",
  "org_uuid": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "status": "STOPPING",
  "config": {
    "model": "Newton::c2_4_7b_251215a172f6d7",
    "datasets": [
      {
        "name": "training-set",
        "split": "train",
        "file_ids": ["file-abc123"]
      }
    ]
  },
  "created_at": "2026-04-27T14:32:18.421000Z",
  "updated_at": "2026-04-27T14:51:33.701000Z",
  "inference_config_path": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt

Use this file to discover all available pages before exploring further.

Overview

This endpoint stops a running fine-tune job. Stopping a job allows it to finalize gracefully — the most recent checkpoint is preserved and any in-progress evaluation is finished — and the job ends in the STOPPED state. To abandon a job without finalizing, use Cancel Job instead.

Path Parameters

job_id
string
required
Identifier of the job to stop (1–64 characters)

Response

Returns the updated job record. The job’s status will transition to STOPPING and then to STOPPED once the runner finishes finalizing.
status
string
Status of the job after the stop request. Typically STOPPING or STOPPED.
updated_at
string
ISO 8601 timestamp of the status change
See Get Job for the full list of fields returned in a job record.
curl -X PUT https://api.u1.archetypeai.app/v0.5/fine-tune/jobs/ftj-my-finetune-run-3de60a5c/stop \
  -H "Authorization: Bearer $ATAI_API_KEY"
{
  "name": "my-finetune-run",
  "id": "ftj-my-finetune-run-3de60a5c",
  "uuid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c",
  "org_uuid": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "status": "STOPPING",
  "config": {
    "model": "Newton::c2_4_7b_251215a172f6d7",
    "datasets": [
      {
        "name": "training-set",
        "split": "train",
        "file_ids": ["file-abc123"]
      }
    ]
  },
  "created_at": "2026-04-27T14:32:18.421000Z",
  "updated_at": "2026-04-27T14:51:33.701000Z",
  "inference_config_path": null
}