run_template
Execute a named workflow template with optional widget overrides. Enqueues the resolved graph and returns a prompt ID, or blocks for outputs when wait is true.
Instructions
ONE-SHOT: run a named workflow template (a bundled pack from list_packs) with optional overrides. Resolves the template's expert graph, applies overrides, and enqueues it — replacing the manual read_pack_workflow → modify_workflow → enqueue_workflow chain. Override keys are '.' (e.g. {'6.text': 'a cat', '3.seed': 42}) — the SAME keys the companion get_template_schema tool reports (when available), so schema→run round-trips; only widget values can be overridden, never graph connections. By default returns {prompt_id} immediately; pass wait:true to block until the job completes and return its outputs (images etc.). Unresolvable template names return a clear error with near-matches.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Block until the job completes and return its outputs. Default false: return {prompt_id} immediately. | |
| template | Yes | Template name — a bundled pack directory (from list_packs), e.g. 'anima-txt2img'. | |
| overrides | No | Widget overrides keyed '<nodeId>.<widget_name>' (get_template_schema's keys), e.g. {'6.text': 'a red fox', '3.steps': 20}. | |
| timeout_s | No | Max seconds to wait when wait:true (default 300). On timeout the job keeps running; poll get_job_status. | |
| disable_random_seed | No | If true, do not randomize seed values (combine with a seed override to reproduce exactly). |