routes

Create Browser Route Run

Start a browser-owned public route run and stream it live (SSE).

The Cheshire run is decoupled from this socket — a detached consumer drives it to a durable terminal even if the browser backgrounds. X-Route-Run-Id flushes with the headers; reconnect/replay is GET /routes/{run_id}/events with Last-Event-ID.

Admission comes before the run row (#1909): a refused ask costs one Valkey increment, not a persisted run nobody will ever read.

post/routes

Request body

promptstring required
localestring
unitsstring nullable
timezonestring nullable

Response

Successful Response

{"stackTrail":"paths:/routes:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.