
Dagster TriggerRun
CertifiedTrigger a Dagster job via GraphQL
Dagster TriggerRun
Trigger a Dagster job via GraphQL
Starts a Dagster job with LaunchPipelineExecution, optionally waits for a terminal status, then returns run metadata. Waiting is disabled by default; when enabled the task polls every pollFrequency (default 5s) until maxDuration (default 30m).
type: io.kestra.plugin.dagster.TriggerRunExamples
Trigger a Dagster job run and wait for completion with Bearer token authentication
id: dagster
namespace: company.team
tasks:
- id: run_dagster_job
type: io.kestra.plugin.dagster.TriggerRun
baseUrl: http://localhost:3000/graphql
jobName: example_job
repository: __repository__
location: dagster_quickstart
wait: true
pollFrequency: PT1S
body:
runConfig:
ops:
example_op:
config:
param: "value"
tags:
source: kestra
namespace: "{{ flow.namespace }}"
flow: "{{ flow.id }}"
task: "{{ task.id }}"
execution: "{{ execution.id }}"
options:
headers:
Authorization: "Bearer {{ secret('DAGSTER_TOKEN') }}"
Trigger a Dagster job without waiting for completion
id: dagster_async
namespace: company.team
tasks:
- id: trigger_job
type: io.kestra.plugin.dagster.TriggerRun
baseUrl: https://dagster.cloud/myorg/prod/graphql
location: my_location
repository: my_repository
jobName: my_job
wait: false
options:
headers:
Authorization: "Bearer {{ secret('DAGSTER_TOKEN') }}"
Installation
Our standard Docker images already include this plugin. If you use a -slim image or another setup, install it with the following command:
kestractl plugins get io.kestra.plugin:plugin-dagster --compatible-for $KESTRA_VERSION For kestractl, use your Kestra version with --compatible-for, or specify an exact plugin version.
Properties
baseUrl *string
Dagster GraphQL endpoint URL
Dagster Cloud usually exposes https://dagster.cloud/<org>/<deployment>/graphql
jobName *string
Job or pipeline name to trigger
location *string
Repository location name
repository *string
Repository name
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150body object
GraphQL body with runConfig and tags
Optional runConfig and tags to pass to Dagster, rendered before sending. tags become Dagster run tags, with values sent as strings.
maxDuration string
PT30MMaximum total wait duration
Default 30m; only used when wait is true
options object
HTTP request options
Optional HTTP settings such as headers (e.g., Authorization)
pollFrequency string
PT5SPolling frequency for run status
Default 5s; only used when wait is true
wait booleanstring
falseWait for the job to complete
Defaults to false; when true the task polls until the run reaches a terminal status
Outputs
endTime string
date-timeEnd time of the run
jobName string
Name of the job that was triggered
runId string
Dagster run ID
startTime string
date-timeStart time of the run
status string
Current run status
Possible values: QUEUED, STARTING, STARTED, SUCCESS, FAILURE, CANCELED