Skip to main content
POST
Plan 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
robot
string
required
prompt
string
required

The behavior, in plain words

Required string length: 3 - 4000
items
RlItem · object[]

Items already in the scene

Maximum array length: 8

Response

Successful Response

robot
string
required
planned_by
enum<string>
required

defaults when the planner was unavailable: the robot's verified defaults

Available options:
model,
defaults
task
Task · object
required

Pass as task to POST /v1/rl_runs

budget
Budget · object
required
object
enum<string>
default:rl_plan
Available options:
rl_plan
Allowed value: "rl_plan"
title
string | null
reasoning
string | null
feasibility
string | null

full, partial or unsupported

feasibility_note
string | null
notes
string[]