dg api reference

dg api

Make REST-like API calls to Dagster Plus.

dg api [OPTIONS] COMMAND [ARGS]...

agent

Manage agents in Dagster Plus.

dg api agent [OPTIONS] COMMAND [ARGS]...

get

Get detailed information about a specific agent.

dg api agent get [OPTIONS] AGENT_ID

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

AGENT_ID: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List all agents in the organization.

dg api agent list [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

alert-policy

Manage alert policies in Dagster Plus.

dg api alert-policy [OPTIONS] COMMAND [ARGS]...

list

List alert policies for a deployment.

dg api alert-policy list [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

sync

Sync alert policies from a YAML file.

dg api alert-policy sync [OPTIONS] FILE_PATH

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

FILE_PATH: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

artifact

Upload and download artifacts in Dagster Plus.

dg api artifact [OPTIONS] COMMAND [ARGS]...

download

Download an artifact from Dagster Plus.

KEY is the artifact key (e.g. “my-model/latest”). PATH is the local file path to save to.

dg api artifact download [OPTIONS] KEY PATH

Options:

--deployment <deployment>: Deployment name for deployment-scoped artifacts. If omitted, artifact is organization-scoped.

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

KEY: Required argument

PATH: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

upload

Upload an artifact to Dagster Plus.

KEY is the artifact key (e.g. “my-model/latest”). PATH is the local file path to upload.

dg api artifact upload [OPTIONS] KEY PATH

Options:

--deployment <deployment>: Deployment name for deployment-scoped artifacts. If omitted, artifact is organization-scoped.

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

KEY: Required argument

PATH: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

asset

Manage assets in Dagster Plus.

dg api asset [OPTIONS] COMMAND [ARGS]...

get

Get specific asset details.

dg api asset get [OPTIONS] ASSET_KEY

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

ASSET_KEY: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get-evaluations

Get automation condition evaluation records for an asset.

Evaluations are only recorded when at least one subcondition has a different value than the previous evaluation.

dg api asset get-evaluations [OPTIONS] ASSET_KEY

Options:

--limit <limit>: Max evaluations to return (default: 50, max: 1000)

--cursor <cursor>: Cursor for pagination (evaluation ID)

--include-nodes: Include the condition evaluation node tree (verbose)

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

ASSET_KEY: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get-events

Get materialization and observation events for an asset.

dg api asset get-events [OPTIONS] ASSET_KEY

Options:

--event-type <event_type>

Filter by event type (default: both)

Options: ASSET_MATERIALIZATION | ASSET_OBSERVATION

--limit <limit>: Max events to return (default: 50, max: 1000)

--before <before>: Events before this ISO timestamp (e.g. 2024-01-15T00:00:00)

--partition <partitions>: Filter by partition key (repeatable)

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

ASSET_KEY: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get-health

Get health and runtime status for an asset.

dg api asset get-health [OPTIONS] ASSET_KEY

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

ASSET_KEY: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List assets with pagination.

dg api asset list [OPTIONS]

Options:

--limit <limit>: Number of assets to return (default: 50, max: 1000)

--cursor <cursor>: Cursor for pagination

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

code-location

Manage code locations in Dagster Plus.

dg api code-location [OPTIONS] COMMAND [ARGS]...

add

Add or update a code location in the deployment.

dg api code-location add [OPTIONS] LOCATION_NAME

Options:

--image <image>: Docker image for the code location

-m, --module-name <module_name>: Python module name

-p, --package-name <package_name>: Python package name

-f, --python-file <python_file>: Python file path

-w, --working-directory <working_directory>: Working directory

--executable-path <executable_path>: Python executable path

-a, --attribute <attribute>: Attribute to load definitions from

--commit-hash <commit_hash>: Git commit hash

--git-url <git_url>: Git repository URL

--location-file, --from <location_file>: YAML file with location configuration

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

LOCATION_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

delete

Delete a code location from the deployment.

dg api code-location delete [OPTIONS] LOCATION_NAME

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

LOCATION_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get

Get detailed information about a specific code location.

dg api code-location get [OPTIONS] LOCATION_NAME

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

LOCATION_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List code locations in the deployment.

dg api code-location list [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

deployment

Manage deployments in Dagster Plus.

dg api deployment [OPTIONS] COMMAND [ARGS]...

delete

Delete a deployment by name.

dg api deployment delete [OPTIONS] NAME

Options:

--allow-delete-full-deployment: Allow deleting a production (full) deployment

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

NAME: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get

Show detailed information about a specific deployment.

dg api deployment get [OPTIONS] NAME

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

NAME: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List deployments in the organization.

dg api deployment list [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--type <deployment_type>

Type of deployments to list (default: production)

Options: production | branch | all

--pr-status <pr_status>

Filter branch deployments by pull request status (only applies with –type branch or all)

Options: OPEN | CLOSED | MERGED

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

settings

Manage deployment settings.

dg api deployment settings [OPTIONS] COMMAND [ARGS]...

get

Get settings for a deployment.

dg api deployment settings get [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

set

Set deployment settings from a YAML file.

dg api deployment settings set [OPTIONS] FILE_PATH

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

FILE_PATH: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

issue

Manage issues in Dagster Plus.

dg api issue [OPTIONS] COMMAND [ARGS]...

get

Get an issue by ID.

dg api issue get [OPTIONS] ISSUE_ID

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

ISSUE_ID: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List issues with pagination.

dg api issue list [OPTIONS]

Options:

--limit <limit>: Number of issues to return (default: 10)

--cursor <cursor>: Cursor for pagination

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

organization

Manage organization in Dagster Plus.

dg api organization [OPTIONS] COMMAND [ARGS]...

saml

Manage SAML SSO configuration.

dg api organization saml [OPTIONS] COMMAND [ARGS]...

remove

Remove identity provider SAML metadata to disable SSO.

dg api organization saml remove [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

upload

Upload identity provider SAML metadata to enable SSO.

dg api organization saml upload [OPTIONS] METADATA_FILE_PATH

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

METADATA_FILE_PATH: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

settings

Manage organization settings.

dg api organization settings [OPTIONS] COMMAND [ARGS]...

get

Get settings for the organization.

dg api organization settings get [OPTIONS]

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

set

Set organization settings from a YAML file.

dg api organization settings set [OPTIONS] FILE_PATH

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

FILE_PATH: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

run

Manage runs in Dagster Plus.

dg api run [OPTIONS] COMMAND [ARGS]...

get

Get run metadata by ID.

dg api run get [OPTIONS] RUN_ID

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

RUN_ID: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

get-events

Get execution log events for a specific run ID.

dg api run get-events [OPTIONS] RUN_ID

Options:

--level <levels>: Filter by log level (DEBUG, INFO, WARNING, ERROR, CRITICAL). Repeatable.

--event-type <event_types>: Filter by event type (e.g. STEP_FAILURE, RUN_START). Repeatable.

--step <step_keys>: Filter by step key (partial matching). Repeatable.

--limit <limit>: Maximum number of log entries to return

--cursor <after_cursor>: Pagination cursor for retrieving more logs

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

RUN_ID: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List runs with optional filtering and pagination.

dg api run list [OPTIONS]

Options:

--limit <limit>: Number of runs to return (default: 50, max: 1000)

--cursor <cursor>: Cursor for pagination (run ID)

--status <statuses>

Filter by run status. Repeatable.

--job <job_name>: Filter by job name

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

schedule

Manage schedules in Dagster Plus.

dg api schedule [OPTIONS] COMMAND [ARGS]...

get

Get specific schedule details.

dg api schedule get [OPTIONS] SCHEDULE_NAME

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

SCHEDULE_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List schedules in the deployment.

dg api schedule list [OPTIONS]

Options:

--status <status>

Filter schedules by status

Options: RUNNING | STOPPED

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

secret

Manage secrets in Dagster Plus.

Secrets are environment variables that are encrypted and securely stored in Dagster Plus. They can be scoped to different deployment levels and code locations.

Security Note: Secret values are hidden by default. Use appropriate flags and caution when displaying sensitive values.

dg api secret [OPTIONS] COMMAND [ARGS]...

get

Get details for a specific secret.

By default, the secret value is not shown for security reasons. Use –show-value flag to display the actual secret value.

WARNING: When using –show-value, the secret will be visible in your terminal and may be stored in shell history. Use with caution.

dg api secret get [OPTIONS] SECRET_NAME

Options:

--location <location>: Filter by code location name

--show-value: Include secret value in output (use with caution - values will be visible in terminal)

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

SECRET_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List secrets in the organization.

By default, secret values are not shown for security reasons. Use ‘dg api secret get NAME –show-value’ to view specific values.

dg api secret list [OPTIONS]

Options:

--location <location>: Filter secrets by code location name

--scope <scope>

Filter secrets by scope

Options: deployment | organization

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

sensor

Manage sensors in Dagster Plus.

dg api sensor [OPTIONS] COMMAND [ARGS]...

get

Get specific sensor details.

dg api sensor get [OPTIONS] SENSOR_NAME

Options:

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Arguments:

SENSOR_NAME: Required argument

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

list

List sensors in the deployment.

dg api sensor list [OPTIONS]

Options:

--status <status>

Filter sensors by status

Options: RUNNING | STOPPED | PAUSED

--json: Output in JSON format for machine readability

--response-schema: Print the JSON Schema of the response model and exit.

-d, --deployment <deployment>: Deployment to target.

-o, --organization <organization>: Organization to target.

--api-token <api_token>: Dagster Cloud API token.

--view-graphql: Print GraphQL queries and responses to stderr for debugging.

Environment variables:

DAGSTER_CLOUD_DEPLOYMENT: Provide a default for --deployment

DAGSTER_CLOUD_ORGANIZATION: Provide a default for --organization

DAGSTER_CLOUD_API_TOKEN: Provide a default for --api-token

dg api​

agent​

get​

list​

alert-policy​

list​

sync​

artifact​

download​

upload​

asset​

get​

get-evaluations​

get-events​

get-health​

list​

code-location​

add​

delete​

get​

list​

deployment​

delete​

get​

list​

settings​

get​

set​

issue​

get​

list​

organization​

saml​

remove​

upload​

settings​

get​

set​

run​

get​

get-events​

list​

schedule​

get​

list​

secret​

get​

list​

sensor​

get​

list​

dg api

agent

get

list

alert-policy

list

sync

artifact

download

upload

asset

get

get-evaluations

get-events

get-health

list

code-location

add

delete

get

list

deployment

delete

get

list

settings

get

set

issue

get

list

organization

saml

remove

upload

settings

get

set

run

get

get-events

list

schedule

get

list

secret

get

list

sensor

get

list