Skip to main content
POST
Start an evaluation

Authorizations

X-API-Key
string
header
required

Organization API key

Headers

Idempotency-Key
string

Optional. Without a key, repeated submissions are treated as separate actions. A blank or over-long key is rejected. Reuse this key when retrying a submission; the SDK generates one per call and reuses it across automatic retries.

Required string length: 1 - 256

Body

application/json
bench_id
string | null

Benchmark ID; use instead of agent_name and benchmark_name.

agent_name
string | null

Use with benchmark_name to select its latest benchmark version.

benchmark_name
string | null

Use with agent_name to select the latest benchmark version.

bypass_ownership
boolean
default:false

Allow a supplied agent to differ from the benchmark owner within the same organization; run attribution uses the benchmark owner.

agent_id
string | null

Optional agent for ownership checks; not a benchmark selector.

Required string length: 1 - 64
base_model_slug
enum<string> | null

Registered base model; mutually exclusive with deployment_id.

Available options:
thinkingmachines/Inkling-Small,
Qwen/Qwen3.5-4B,
Qwen/Qwen3.5-397B-A17B,
Qwen/Qwen3.6-35B-A3B,
Qwen/Qwen3.8-27B,
nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16,
nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-BF16,
nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16,
nvidia/NVIDIA-Nemotron-3.5-Super-120B-A12B-BF16,
openai/gpt-6.1-sol,
openai/gpt-6-sol,
openai/gpt-6-astra,
openai/gpt-5.6-sol,
openai/gpt-5.6-luna,
anthropic/claude-opus-5.5,
anthropic/claude-sonnet-5.5,
openai/gpt-5-mini,
openai/gpt-5.4-mini,
openai/gpt-5.5,
anthropic/claude-sonnet-4.6,
google/gemini-3.1-pro-preview,
z-ai/glm-5.3,
z-ai/glm-5.3-flash,
moonshotai/kimi-k3
options
RunOptions · object | null

Run settings; omission, null, and an empty object preserve defaults.

parent_checkpoint_id
string | null

Checkpoint to resume training from or evaluate; must match the selected base model. Checkpoint evaluations inherit supported token and turn limits from the source training run unless the evaluation overrides them.

Required string length: 1 - 64
display_name
string | null
Required string length: 1 - 256
deployment_id
string | null

Evaluate the exact hosted checkpoint and pool of a ready deployment.

Required string length: 1 - 64
task_split
enum<string>
default:test

Evaluate test tasks by default; all includes both test and train tasks.

Available options:
test,
all

Response

Successful Response

bench_id
string
required

Benchmark evaluated by this run.

eval_run_id
string
required

Evaluation run created for this request.

display_name
string | null
required

User-facing name for the evaluation run.

task_selection
EvalTaskSelection · object | null

Task coverage fixed at launch; null for legacy or diagnostic runs.