Skip to main content
POST
Validate Sim Run

Authorizations

Authorization
string
header
required

A Kite API key (kite_...), from Platform API → Keys in the dashboard.

Headers

Kite-Version
enum<string>
default:2026-09-27

The dated contract your code was written against. Without it you get 2026-09-27; every response says which version served it.

Available options:
2026-09-27

Body

application/json

The checks a create runs (kite plan), without creating anything or spending anything.

spec_yaml
string
required

The spec file's text, as written

Required string length: 1 - 2000000
spec_path
string
default:spec.yaml

Its path in your workspace: what errors cite

Maximum string length: 500
files
Files · object

Each path the spec names, as it names it

overrides
string[]

FIELD=VALUE, as kite --set

Maximum array length: 100
kite_version
string | null

The Kite release to run; default the latest

Maximum string length: 40

Response

Successful Response

ok
boolean
required
plan
Plan · object
required

kite plan's answer: the resolved spec, each evaluator's status, the episodes and the estimate

price
Price · object
required

What a run of it reserves: its tier, the tier's tokens per hour, the cap in minutes and the tokens reserved (0 while billing is off)

object
enum<string>
default:sim_run_validation
Available options:
sim_run_validation
Allowed value: "sim_run_validation"
kite_version
string | null