autoscientist

Retrieve an AutoScientist run

Changed on Oct 20, 2026

get/api/v1/autoscientist/{experiment_id}

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/adaptionlabs/apis/adaption-api/docs/api/v1/autoscientist/:experiment_id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

experiment_idstring required

Response

idstring required

AutoScientist run id.

dataset_idstring nullable required

Public id of the dataset the run trained on.

modelstring nullable required

Resolved base model id used, including an automatically selected model.

status'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' required

created_atstring date-time required

completed_atstring date-time nullable required

When the run reached a terminal state. Null while it is still running.

iterations_completednumber required

Number of completed iterations.

max_iterationsnumber required

Resolved maximum number of iterations, including the model-specific default.

target_win_ratenumber required

Resolved target win rate for the AutoScientist loop, including the model-specific default.

best_win_ratenumber nullable

Best win rate achieved so far.

training_method'instruction' | 'alignment' required

The objective this run is training. Resolved at creation — a requested alignment is downgraded to instruction when the dataset is not preference pairs, so read this back to confirm what actually runs.

download_availableboolean required

True when the best trained artifact can be downloaded.

errorstring nullable

Why the run failed. Null unless status is failed.

Example response

{
  "best_hyperparams": {
    "n_epochs": 1,
    "learning_rate": 0.00005,
    "lora_r": 8,
    "lora_trainable_modules": "q_proj,v_proj",
    "min_lr_ratio": 0.1,
    "scheduler_num_cycles": 0.5,
    "warmup_ratio": 0.03,
    "max_grad_norm": 2,
    "dpo_beta": 0.1
  }
}

Changes

Oct 20, 20267398ff1eeeba Revision changes
- info
  removed the constant enum value from the ///// response property for the response status
Sep 15, 2026f4d1edd8f3d1 Revision changes
- breaking
  the response's property type changed from object to number for status
- breaking
  the response's property type changed from object to string, and format from no format to date-time for status
- breaking
  the response's property type changed from object to string for status
- breaking
  the response's property type changed from object to string for status
- breaking
  the response's property type changed from object to string for status
- info
  the response's property default value 0 was added for the status
- info
  the response's property default value 0.5 was added for the status
- info
  the response's property default value 0 was added for the status

Operation history