Runs API

ID of the notebook to run.

Run the notebook as a detached run so it does not affect the live editor session. Defaults to true; set to false to execute in the live editor kernel, reuse its state, and update outputs in the live app editor.

Storage mode for the detached run. `read_write` (default) mounts project storage as writable; `readonly` mounts it as read-only so the run cannot modify the persistent project storage, but can create ephemeral files outside of the persistent project storage directory. Only applies to detached runs.

Machine type for the run, as an `id` from `GET /machine-types`. Defaults to the project's machine type. Only supported for detached runs.

Optional non-empty list of unique block IDs to run. Only supported in live mode, so set `detached` to `false` when providing it. Omit to run the full notebook. Without `runDependentBlocks`, selected blocks run in request order except that selected input blocks with values in `inputs` run first. Input blocks with values in `inputs` that are not selected also run before the selected blocks.

When true and `blockIds` is provided, also run downstream blocks that depend on the selected blocks.

Input values used when this run executes, keyed by the input `name` returned from `GET /notebooks/{notebookId}`. Values must match the referenced input block type. In live mode (`detached: false`), these values can remain in the editor kernel and affect later executions until overwritten or the kernel is restarted. They do not change the notebook's saved input values.