Skip to main content
PUT
/
fine-tune
/
jobs
/
{job_id}
/
cancel
curl -X PUT https://api.u1.archetypeai.app/v0.5/fine-tune/jobs/ftj-my-finetune-run-3de60a5c/cancel \
  -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": "CANCELLED",
  "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 cancels a fine-tune job in the authenticated organization. Cancellation terminates the job immediately without finalizing — no further checkpoints are written, and the job ends in the CANCELLED state. If you want the job to wind down gracefully and preserve its most recent checkpoint, use Stop Job instead.

Path Parameters

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

Response

Returns the updated job record. The job’s status will transition to CANCELLED.
status
string
Status of the job after the cancel request. Typically CANCELLED.
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/cancel \
  -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": "CANCELLED",
  "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
}