Setting the file. One moment.
Subchapter 2.58
references/cli/api/run/INDEX.mdMarkdown2 KBView on GitHub
Commands for interacting with Dagster runs via dg api run.
When the Dagster Plus MCP server is connected, prefer its tools for the commands it covers. See general.md for how to choose.
| Command | MCP tool |
|---|---|
list | list_runs |
get | get_run |
get-events | get_run_logs |
launch | launch_job_run, launch_asset_run |
get_run_logs maps to get-events, not to get-logs — despite its name it returns structured run events rather than compute logs.
The MCP server also offers run actions with no CLI counterpart. All three require deployment_name.
rerun_run — re-execute a run. Params: run_id (required), strategy, use_parent_run_tags (default true), extra_tags.rerun_backfill — re-execute a backfill. Params: backfill_id (required), then the same as rerun_run.terminate_run — terminate an in-flight run. Params: run_id (required).strategy is FROM_FAILURE (default), ALL_STEPS, or FROM_ASSET_FAILURE. Retrying only the failed portion of a run or backfill is the FROM_FAILURE default; pass ALL_STEPS to re-execute everything.