Skip to main content

Latest environment state in the dbt Cloud Discovery API

Users of the Discovery API can now query the latest state of their environment, meaning there's no need to consolidate results across jobs or artifact files. The environment essentially represents the latest production state of a dbt project. The new environment endpoint is in public preview and can be used with the existing modelByEnvironment endpoint for historical analysis. For details, refer to these docs:


dbt Labs is continually enhancing the dbt Cloud Discovery API to ensure you have access to timely, rich, and reliable metadata about your dbt runs. In the coming year, we’ll expand the range of questions the API helps answer so you can more easily understand the state, meaning, and structure of your data to inform data development and analysis experiences.

  • [Now] Query across jobs & lineage Get the latest state of a dbt DAG (production environment) to find, understand, and trust the right dataset to analyze.
    • [Ongoing] Improvements Enhanced developer ergonomics, state fidelity, and metadata timeliness.
  • [Soon] Query across projects View and manage cross-project lineage using public models to define, use, and manage governed datasets for enhanced collaboration across teams.
  • [Later] Query over time Understand longer-term dbt Cloud execution result trends to optimize pipeline performance and costs, such as improving costly, error-prone, or slow datasets.