> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# launchRun

> Gateway RPC for starting a workflow run.

* Method: `launchRun`
* Scope: `run:write`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ workflow, input?, options? }`
* Response: `{ runId, workflow }`

`options.startedBy` is optional durable self-reported provenance, separate from
the authenticated `auth.triggeredBy` identity: `{ harness?, sessionId?, prompt?,
detected?: true }`. Harness/session are limited to 64/256 Unicode code points;
the explicit-only prompt is visibly clipped at 8,192 code points. Gateway
callers supply this object directly; the Gateway does not infer its daemon
environment.

Errors are versioned as `v1` and include `InvalidRequest`, `InvalidInput`, `Unauthorized`, `Forbidden`, and `Internal`.