v1

latestOpenAPI 3.1.02026-07-175793186.0 KB

optimization

Get Run

Get a single optimization run by ID.

get/api/v1/optimization/runs/{run_id}

Path parameters

run_idstring required

Identifier of the optimization run to fetch.

Response

Successful Response

idstring required

Unique run identifier.

statusstring required

Run status: running, completed, or failed.

module_slugstring nullable

Module slug when server-side dispatch was used.

program_specstring required

DSPy program specification that was optimized.

optimizerstring required

Optimizer backend that was used.

autostring nullable

Optimization intensity level.

train_rationumber

Train/validation split ratio.

dataset_pathstring nullable

Path to the dataset used.

reflection_profile_idstring nullable

LLM provider profile id used for GEPA reflection/proposal, when selected.

reflection_model_idstring nullable

Model id used for GEPA reflection/proposal, when selected.

raw_trace_export_pathstring nullable

Full raw trace export path, when present.

distilled_trace_bundle_pathstring nullable

Distilled GEPA trace evidence bundle path, when present.

prompt_snapshot_pathstring nullable

Prompt snapshot or diff artifact path, when present.

train_examplesinteger nullable

Number of training examples used.

validation_examplesinteger nullable

Number of validation examples used.

validation_scorenumber nullable

Validation score from the optimized program.

output_pathstring nullable

Filesystem path where the optimized program was saved.

manifest_pathstring nullable

Filesystem path to the optimization manifest.

errorstring nullable

Error message when the run failed.

phasestring nullable

Current phase of the optimization run.

started_atstring required

ISO timestamp when the run started.

completed_atstring nullable

ISO timestamp when the run completed.