Skip to main content

TriggerJobs

POST 
/api/v1/workspaces/:workspace_id/scripts/trigger

Triggers jobs by selectors (fnmatch patterns matched against each script's triggers array, e.g. 'tag:backfill', 'schedule:*', 'batch') and/or by job_refs (per-script invocation that fires each script via its default_trigger, or manual:<ref> if no default exists).

When the same script matches both selectors and job_refs, the union of matched triggers is fed to pick_trigger, which prefers default_trigger if present.

Jobs are ordered by dependencies and freshness gating is mandatory — downstream jobs whose upstream isn't fresh are skipped (status='skipped_fresh'). For single-job bypass, use the create_run endpoint with skip_freshness=True.

Supports dry_run mode to preview matched jobs without creating runs.

Requires CREATE_RUN permission (workspace viewers can trigger interactive jobs).

Request​

Responses​

Document created, URL follows

Response Headers