dbt

dbt Cloud Discovery API

Every time dbt Cloud runs a project, it generates and stores information about the project. The Discovery API exposes that metadata including details about models, sources, exposures, and execution results so teams can understand and govern their DAG.

Documentation GitHub OpenAPI

Documentation

📖

Documentation

https://docs.getdbt.com/docs/dbt-cloud-apis/discovery-api

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/dbt/refs/heads/main/openapi/dbt-cloud-discovery-api-openapi.yml

OpenAPI Specification

openapi: 3.1.0
info:
  title: dbt Cloud Discovery API
  description: >-
    The dbt Cloud Discovery API exposes metadata generated when dbt Cloud
    runs a project, including details about models, sources, exposures,
    seeds, snapshots, tests, and execution results. The API is GraphQL-based.
  version: "1.0"
servers:
  - url: https://metadata.cloud.getdbt.com/graphql
    description: Discovery API GraphQL endpoint
tags:
  - name: Metadata
paths:
  /graphql:
    post:
      summary: Execute a Discovery API GraphQL query
      operationId: executeDiscoveryQuery
      tags:
        - Metadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              properties:
                query:
                  type: string
                variables:
                  type: object
      responses:
        "200":
          description: GraphQL response containing requested metadata.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token
security:
  - bearerAuth: []