Skip to main content
POST
/
fine-tune
/
jobs
curl -X POST https://api.u1.archetypeai.app/v0.5/fine-tune/jobs \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-finetune-run",
    "config": {
      "model": "Newton::c2_4_7b_251215a172f6d7",
      "datasets": [
        {
          "name": "training-set",
          "split": "train",
          "file_ids": ["file-abc123"]
        },
        {
          "name": "eval-set",
          "split": "eval",
          "file_ids": ["file-def456"]
        }
      ]
    }
  }'

{
  "name": "my-finetune-run",
  "id": "ftj-my-finetune-run-3de60a5c",
  "uuid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c",
  "org_uuid": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "status": "REGISTERED",
  "config": {
    "model": "Newton::c2_4_7b_251215a172f6d7",
    "datasets": [
      {
        "name": "training-set",
        "split": "train",
        "file_ids": ["file-abc123"]
      },
      {
        "name": "eval-set",
        "split": "eval",
        "file_ids": ["file-def456"]
      }
    ]
  },
  "created_at": "2026-04-27T14:32:18.421000Z",
  "updated_at": "2026-04-27T14:32:18.421000Z",
  "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

Create a new fine-tune job for the authenticated organization. The job runs the specified model against one or more datasets, partitioned into train and eval splits. Once created, a job is REGISTERED and progresses through STARTING → RUNNING → FINALIZING → COMPLETED (or STOPPED, CANCELLED, FAILED).

​
Request Body

​
name
string
required
Human-readable name for the job
​
id
string
Optional client-supplied identifier for the job (1–64 characters). If omitted, an ID will be generated by the server.
​
config
object
required
Configuration for the fine-tune job

​
Response

​
name
string
Name of the job
​
id
string
Job identifier
​
uuid
string
Server-generated UUID for the job
​
org_uuid
string
UUID of the organization that owns the job
​
status
string
Current status of the job. One of UNKNOWN, REGISTERED, STARTING, RUNNING, COMPLETED, FINALIZING, STOPPING, STOPPED, CANCELLED, FAILED.
​
config
object
Resolved configuration for the job, including the selected model and datasets
​
created_at
string
ISO 8601 timestamp when the job was created
​
updated_at
string
ISO 8601 timestamp when the job was last updated
​
inference_config_path
string
Path to the inference configuration produced by the job. Populated once the job has produced inference artifacts.
curl -X POST https://api.u1.archetypeai.app/v0.5/fine-tune/jobs \
  -H "Authorization: Bearer $ATAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-finetune-run",
    "config": {
      "model": "Newton::c2_4_7b_251215a172f6d7",
      "datasets": [
        {
          "name": "training-set",
          "split": "train",
          "file_ids": ["file-abc123"]
        },
        {
          "name": "eval-set",
          "split": "eval",
          "file_ids": ["file-def456"]
        }
      ]
    }
  }'

{
  "name": "my-finetune-run",
  "id": "ftj-my-finetune-run-3de60a5c",
  "uuid": "8f2c1e5a-7b3d-4d9e-9c1a-2f5b7d8e4a6c",
  "org_uuid": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
  "status": "REGISTERED",
  "config": {
    "model": "Newton::c2_4_7b_251215a172f6d7",
    "datasets": [
      {
        "name": "training-set",
        "split": "train",
        "file_ids": ["file-abc123"]
      },
      {
        "name": "eval-set",
        "split": "eval",
        "file_ids": ["file-def456"]
      }
    ]
  },
  "created_at": "2026-04-27T14:32:18.421000Z",
  "updated_at": "2026-04-27T14:32:18.421000Z",
  "inference_config_path": null
}