dbt Cloud

dbt Cloud is the analytics-engineering platform from dbt Labs for transforming data in the warehouse. It exposes the Administrative API for managing accounts, projects, jobs, runs, and environments, the Discovery (Metadata) API for project metadata and lineage via GraphQL, and the Semantic Layer API for querying governed metrics over GraphQL and JDBC.

3 APIs 0 Features

DataAnalytics EngineeringData TransformationELTSemantic Layer

APIs

dbt Cloud Administrative API

REST API (v2 and v3) over Bearer-token / service-token auth for programmatic administration of dbt Cloud - listing and triggering jobs, polling and cancelling runs, downloading ...

dbt Cloud Discovery (Metadata) API

GraphQL API for fetching metadata about the state and health of a dbt project - models, sources, tests, exposures, lineage/DAG, and execution results - queried with a Metadata O...

dbt Cloud Semantic Layer API

APIs for querying governed metrics and dimensions defined in the dbt Semantic Layer - a GraphQL API and a JDBC driver (ArrowFlight SQL) - with standard metadata functionality, a...

Collections

dbt Cloud Administrative API

OPEN

Pricing Plans

Dbt Cloud Plans Pricing

4 plans

PLANS

Rate Limits

Dbt Cloud Rate Limits

6 limits

RATE LIMITS

FinOps

Dbt Cloud Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: dbt Cloud Administrative API
  version: '2'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Accounts
    type: folder
  items:
  - info:
      name: List Accounts
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/
    docs: List the accounts the authenticated token can access.
  - info:
      name: Retrieve Account
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/
    docs: Retrieve a single account by ID.
- info:
    name: Projects
    type: folder
  items:
  - info:
      name: List Projects
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/projects/
    docs: List projects in an account.
  - info:
      name: Create Project
      type: http
    http:
      method: POST
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/projects/
      body:
        type: json
        data: "{\n  \"name\": \"<string>\"\n}"
    docs: Create a project in an account.
  - info:
      name: Retrieve Project
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/projects/{{id}}/
    docs: Retrieve a project by ID.
- info:
    name: Jobs
    type: folder
  items:
  - info:
      name: List Jobs
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/jobs/
    docs: List jobs in an account, optionally filtered by project.
  - info:
      name: Create Job
      type: http
    http:
      method: POST
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/jobs/
      body:
        type: json
        data: "{\n  \"project_id\": 0,\n  \"environment_id\": 0,\n  \"name\": \"<string>\",\n  \"execute_steps\": [\"dbt run\"\
          ]\n}"
    docs: Create a job in an account.
  - info:
      name: Retrieve Job
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/jobs/{{id}}/
    docs: Retrieve a job by ID.
  - info:
      name: Trigger Job Run
      type: http
    http:
      method: POST
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/jobs/{{job_id}}/run/
      body:
        type: json
        data: "{\n  \"cause\": \"Triggered via API\"\n}"
    docs: Trigger a job to run.
- info:
    name: Runs
    type: folder
  items:
  - info:
      name: List Runs
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/runs/
    docs: List runs in an account, with optional filtering and ordering.
  - info:
      name: Retrieve Run
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/runs/{{id}}/
    docs: Retrieve a run by ID.
  - info:
      name: Cancel Run
      type: http
    http:
      method: POST
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/runs/{{run_id}}/cancel/
    docs: Cancel a run that is queued or in progress.
- info:
    name: Run Artifacts
    type: folder
  items:
  - info:
      name: List Run Artifacts
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/runs/{{run_id}}/artifacts/
    docs: List artifact files generated by a completed run.
  - info:
      name: Retrieve Run Artifact
      type: http
    http:
      method: GET
      url: https://cloud.getdbt.com/api/v2/accounts/{{account_id}}/runs/{{run_id}}/artifacts/manifest.json
    docs: Download a specific artifact file (e.g. manifest.json, catalog.json, run_results.json) from a run.