New260+ blocks and 240+ tools are now fully documented
DocumentationReferenceTool IntegrationsDeveloper Tools
Tool

Dagster

Launch and manage data pipeline runs in Dagster

Integrate Dagster data orchestration into your workflows. Launch job runs, poll status, fetch execution logs, inspect schedules, and terminate in-progress runs — all from within a Zelaxy workflow.

Overview

PropertyValue
Typedagster
CategoryTool — Data Orchestration
AuthAPI Key (Dagster-Cloud-Api-Token header — optional for OSS, required for Dagster+)

Operations

OperationTool IDDescription
Launch Rundagster_launch_runTrigger a new job run on a Dagster instance
Get Rundagster_get_runRetrieve the status and details of a run by its ID
Get Run Logsdagster_get_run_logsFetch execution event logs for a specific run
List Runsdagster_list_runsList recent runs, optionally filtered by job name or status
Terminate Rundagster_terminate_runTerminate an in-progress run
List Jobsdagster_list_jobsList all jobs across all repositories in the instance
List Schedulesdagster_list_schedulesList all schedules in a Dagster repository

Configuration

SettingTypeRequiredDescription
hoststringYesDagster instance URL, e.g. https://myorg.dagster.cloud/prod. Trailing slash is stripped automatically. Used by all operations.
apiKeystring (secret)NoDagster+ API token. Set as {{DAGSTER_API_KEY}}. Sent as the Dagster-Cloud-Api-Token header. Leave blank for self-hosted OSS instances that do not require auth.
repositoryLocationNamestringYes (Launch Run, List Schedules)The code location name as it appears in the Dagster deployment (e.g. my_repo_location).
repositoryNamestringYes (Launch Run, List Schedules)Repository name within the code location. Commonly __repository__ for single-repo locations.
jobNamestringYes (Launch Run)The name of the job to run.
runConfigJsonstringNo (Launch Run)Optional run configuration as a JSON string, e.g. {"ops": {"my_op": {"config": {"param": "value"}}}}. Parsed and passed as runConfigData.
tagsstringNo (Launch Run)Optional tags as a JSON array of {"key": "...", "value": "..."} objects.
runIdstringYes (Get Run, Get Run Logs, Terminate Run)The globally unique run ID to inspect or terminate.
afterCursorstringNo (Get Run Logs)Pagination cursor returned by a previous Get Run Logs call, for fetching the next page of events.
limitnumberNo (Get Run Logs, List Runs)Maximum number of records to return. Defaults to 20 for List Runs.
jobName (filter)stringNo (List Runs)Filter runs by job name.
statusesstringNo (List Runs)Comma-separated run statuses to filter by, e.g. SUCCESS,FAILURE. Valid values: SUCCESS, FAILURE, STARTED, QUEUED, CANCELING, CANCELED.
scheduleStatusstringNo (List Schedules)Filter schedules by status: RUNNING or STOPPED. Omit to return all schedules.

Outputs

Launch Run

FieldTypeDescription
runIdstringThe globally unique ID of the newly launched run

Get Run

FieldTypeDescription
runIdstringRun ID
jobNamestringJob name (may be null)
statusstringCurrent run status (e.g. STARTED, SUCCESS, FAILURE)
startTimenumberRun start time as a Unix timestamp (may be null)
endTimenumberRun end time as a Unix timestamp (may be null)
runConfigYamlstringRun configuration serialized as YAML (may be null)
tagsjsonArray of {key, value} tag objects attached to the run (may be null)

Get Run Logs

FieldTypeDescription
eventsjsonArray of log event objects, each with type, message, timestamp, level, stepKey, and eventType
cursorstringCursor to use with afterCursor for the next page of events
hasMorebooleanWhether more log events are available beyond this page

List Runs

FieldTypeDescription
runsjsonArray of run objects, each with runId, jobName, status, tags, startTime, and endTime

Terminate Run

FieldTypeDescription
runIdstringThe run ID that was terminated
statusstringTermination status (TERMINATED)

List Jobs

FieldTypeDescription
jobsjsonArray of job objects, each with name (job name) and repositoryName

List Schedules

FieldTypeDescription
schedulesjsonArray of schedule objects, each with name, cronSchedule, jobName, status, id, description, and executionTimezone

Example

[Starter] → [Dagster: Launch Run] → [Dagster: Get Run] → [Agent: summarize result]

Connect a Starter block that fires on a webhook or schedule, then pass {{DAGSTER_API_KEY}} as the API key and your instance URL (e.g. {{DAGSTER_HOST}}) as the host. The Launch Run block triggers {{starter.jobName}} in repository location my_repo_location; downstream blocks can poll status using {{dagster_launch_run.runId}} in a Get Run block, and an Agent block can turn the final status and runConfigYaml into a human-readable summary.

Tips

  • OSS vs Dagster+apiKey is optional for self-hosted OSS Dagster instances that have no auth configured. For Dagster+ (cloud), supply your user token or organization token via {{DAGSTER_API_KEY}}.
  • Repository selectorrepositoryLocationName is the code-location name shown in the Deployments tab of the Dagster UI; repositoryName is almost always __repository__ for single-repo locations. Use the List Jobs operation to discover the correct values programmatically.
  • Polling for completion — Dagster runs are asynchronous. After Launch Run, use a loop block calling Get Run with the returned runId until status is SUCCESS or FAILURE. Check startTime and endTime to calculate duration.
  • Log pagination — Get Run Logs returns a cursor and hasMore flag. Pass cursor as afterCursor in a subsequent call to retrieve the next page. Limit per page defaults to the Dagster server's maximum if not specified.
  • Status filter format — The statuses param for List Runs is a comma-separated string (e.g. SUCCESS,FAILURE), not a JSON array. The tool splits and trims it automatically before sending the GraphQL query.