---
id: dagster-graphql
version: "1.13.17"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# dagster-graphql — The GraphQL API for Dagster.

License: permissive · Maintenance: active · Downloads: 7.8M/mo

## What it is and what it does

dagster-graphql is the GraphQL API layer for Dagster, the cloud-native data pipeline orchestrator. It exposes Dagster's core data model—assets, pipelines, runs, and metadata—through a GraphQL interface, allowing programmatic queries and mutations against a running Dagster instance. This package is typically used alongside dagster and its web server to enable external tools, dashboards, or automation scripts to query pipeline state, asset lineage, run history, and observability data.

The package depends on gql, graphene, requests, and starlette to handle GraphQL transport, schema definition, HTTP communication, and async web serving. It is designed for developers building integrations with Dagster, creating custom dashboards, or automating workflows that need to inspect or interact with Dagster's orchestration state programmatically.

Use it for:

- Query asset lineage and dependencies from a Dagster instance to build custom lineage visualizations or impact analysis tools.
- Fetch pipeline run history and execution logs via GraphQL for integration with external monitoring or alerting systems.
- Build custom dashboards or web applications that display Dagster asset status, run metrics, and data quality signals.
- Automate workflows that depend on Dagster state—e.g., trigger downstream systems when specific assets complete successfully.
- Integrate Dagster metadata into data catalogs or governance tools by querying asset definitions, owners, and tags.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a GraphQL API interface for querying and interacting with Dagster data pipelines, assets, and orchestration metadata.

Yes, if you need programmatic GraphQL access to a Dagster instance. The package is actively maintained, has no known vulnerabilities, and integrates cleanly with the Dagster ecosystem. Install it when building external tools, dashboards, or automation that queries Dagster's orchestration state; it is not a standalone tool but a necessary dependency for GraphQL-based Dagster integrations.

## Install

pip install dagster-graphql
uv add dagster-graphql
poetry add dagster-graphql

## Installing dagster-graphql

Before you install: Low friction install with a small, stable dependency footprint. The package is actively maintained with a recent release and no known vulnerabilities, backed by a well-established project with strong community engagement.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

pip install dagster-graphql

import dagster_graphql
from gql import Client
from gql.transport.requests import RequestsHTTPTransport

transport = RequestsHTTPTransport(url="http://localhost/graphql")
client = Client(transport=transport)
# Execute queries against the Dagster GraphQL endpoint

Requires a running Dagster instance with GraphQL endpoint exposed; Python 3.10 or later (requires_python >=3.10,<3.15).

Verify before relying:

- Specific GraphQL schema coverage and which Dagster operations are queryable through this API
- Whether this package is intended for direct use or primarily as a dependency of dagster-webserver
- Performance characteristics when querying large asset graphs or pipeline histories

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

graphql api for dagster, dagster pipeline graphql, query dagster assets graphql, dagster orchestration api, dagster metadata graphql interface, graphql dagster integration, dagster web api, data-orchestration, graphql-api, pipeline-metadata

[View on SkillFed](https://skillfed.io/packages/dagster-graphql) · [View on PyPI](https://pypi.org/project/dagster-graphql/)