Skip to main content
POST
/
fine_tuning
/
jobs
/
{id}
/
cancel
curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/cancel \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "CANCELLED",
  "checkpoint_id": null,
  "fine_tuned_model": null,
  "finished_at": 1765201999,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}
Requires version 1.1.5 or later of the Archetype platform.

​
Overview

Cancel a fine-tuning job. Force-stops the run (worker pods are killed without a final checkpoint) and tears down its resources. A cancelled job cannot be resumed; use the Pause Job endpoint for a graceful, resumable stop instead.

​
Request

​
id
string
required
A TypeID-encoded identifier with the FineTuningJobId prefix, which identifies the fine-tuning job.

​
Response

Returns a description of the fine-tuning job after cancellation.
​
object
string
required
The object type. Always fine_tuning.job.
​
id
string
required
A unique identifier for the fine-tuning job.
​
name
string
required
The human-readable name supplied when the job was created.
​
model
string
required
The base model being fine-tuned.
​
created_at
integer
required
The Unix timestamp (in seconds) at which the job was created.
​
org_id
string
required
The organization that owns the job.
​
status
string
required
The job’s current lifecycle stage. One of PENDING, ADMITTED, RUNNING, COMPLETED, FAILED, PREEMPTED, CANCELLED, PAUSED, INTERRUPTED. To determine whether a COMPLETED job was fully or partially successful, or produced no output, see the value of the outcome property.
​
training_files
array
required
Identifiers of the files used to train the model.
​
validation_files
array
required
Identifiers of the files used to evaluate the model during training.
​
errors
array
required
Failure detail when the job has failed, as the platform error envelope (a list of {code, message, suggestion, error_uid}). Empty while the job is queued/running or on success. See Error Handling for information about handling platform errors.
​
checkpoint_id
string
The checkpoint the job was started from, or null if it trained from the base model.
​
fine_tuned_model
string
The name of the model produced by the job. This is available once training has succeeded but is null until then.
​
finished_at
integer
The Unix timestamp (in seconds) at which the job finished, or null if it is not yet complete.
​
outcome
string
For a COMPLETED job, this string indicates whether it succeeded fully (SUCCESS), partially (PARTIAL), or produced nothing (FAILED); null for any non-completed status.
​
seed
integer
Seed. The random seed used for the job.
​
user_provided_suffix
string
The suffix supplied on the request, applied to the fine-tuned model’s name.
curl -X POST https://api.u1.archetypeai.app/v0.6/fine_tuning/jobs/your-job-id/cancel \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "object": "fine_tuning.job",
  "id": "your-job-id",
  "name": "my-tune",
  "model": "newton",
  "created_at": 1765201323,
  "org_id": "your-org",
  "status": "CANCELLED",
  "checkpoint_id": null,
  "fine_tuned_model": null,
  "finished_at": 1765201999,
  "outcome": null,
  "seed": 42,
  "user_provided_suffix": "v2",
  "training_files": ["fil_..."],
  "validation_files": ["fil_..."],
  "errors": []
}