Run a saved Rig for real
rig_runRUN a rig, for real, right now. Without this an outside agent could AUTHOR a rig, schedule it and hang a webhook on it — but never run one on demand, and so never test the thing it just built. Name the rig by rig_id (one you own or adopted) OR by provider_id + external_id (a published listing — this adopts YOUR OWN copy first, then runs it, which also heals a stale adopted copy). input is whatever the rig's input declares (a token address, a URL, a query). The run bills the CALLER's own allowance and executes REAL tools — including money steps if the rig has them and you have granted a mandate, so read the rig before running someone else's. Returns immediately; results land as TRACES. Every answer carries run_id and stage_url: a hosted rokha.ai page showing this run's dashboard to whoever may read the run — hand it to your user. wait:true + render:true also returns stage_html (the dashboard as one self-contained HTML document, <=200 KB) to render yourself in a sandboxed frame (iframe sandbox=allow-scripts, never allow-same-origin); GET /api/rigs/runs/<run_id>/stage returns {title, html} later. A PAID rig answers 402 purchase_required until you hold it: product_get shows the price and any PACK that carries it; product_checkout buys it (x402 / usdc / sol, no browser). Requires Authorization: Bearer or an rk_ key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | true = hold the call until the run finishes (up to ~5 min) and return its output, steps, status and trace_id in one answer. Default false: returns at once, results land as traces (trace_search by rig_id). | |
| input | No | What the run works on. Omit only for input-less rigs. | |
| render | No | With wait:true: also return stage_html, the run's dashboard as one self-contained HTML document (<=200 KB), to render in a sandboxed frame. stage_url is always returned. | |
| rig_id | No | UUID of a rig you own or adopted. | |
| external_id | No | With provider_id. | |
| provider_id | No | With external_id: run a PUBLISHED listing (adopts your own copy first). |