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

  • Base URL
    https://api.imperfect.co (the document declares no server; this is the origin it was published from)
  • URL
    https://api.imperfect.co/routes
  • Auth
    none declared

Request body

promptstring required
localestring
unitsstring nullable
timezonestring nullable

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 62 revisions of this API.