Skip to content


An unaffiliated python interface for dbt Cloud APIs

Coverage Package version Downloads


Interactive Demo:

Source Code:

V2 Docs:

V3 Docs:

Quick Intro


dbtc is an unaffiliated python interface to various dbt Cloud API endpoints.

This library acts as a convenient interface to two different APIs that dbt Cloud offers:

  • Cloud API: This is a REST API that exposes endpoints that allow users to programatically create, read, update, and delete resources within their dbt Cloud Account.
  • Metadata API: This is a GraphQL API that exposes metadata generated from a job run within dbt Cloud.


Python 3.7+

  • Requests - The elegant and simple HTTP library for Python, built for human beings.
  • Typer - Library for building CLI applications


pip install dbtc Successfully installed dbtc restart ↻

Basic Usage


The interface to both APIs are located in the dbtCloudClient class.

The example below shows how you use the cloud property on an instance of the dbtCloudClient class to access methods that allow for programmatic control over dbt Cloud resources.

from dbtc import dbtCloudClient

client = dbtCloudClient()

project =, project_id=1)


All of the methods available via the dbtCloudClient class are also available through the command line via dbtc.

The same code above can be written as follows using the CLI:

dbtc get-project --account-id=1 --project-id=1


This project is licensed under the terms of the MIT license.