Data Engineering Bearer Token

dbt Cloud REST API

Transform data in your warehouse with SQL and Python

dbt Cloud provides a REST API for managing data transformation workflows, models, and jobs in your modern data stack. The API enables developers to programmatically trigger runs, retrieve job metadata, manage environments, and integrate dbt transformations into automated data pipelines. It's essential for orchestrating analytics engineering workflows at scale.

Base URL https://cloud.getdbt.com/api/v2

API Endpoints

Method	Endpoint	Description
GET	`/accounts/{account_id}/projects/`	List all projects in an account
GET	`/accounts/{account_id}/projects/{project_id}/`	Retrieve details of a specific project
POST	`/accounts/{account_id}/jobs/{job_id}/run/`	Trigger a job run for a specific job
GET	`/accounts/{account_id}/runs/`	List all runs in an account with filtering options
GET	`/accounts/{account_id}/runs/{run_id}/`	Get detailed information about a specific run
POST	`/accounts/{account_id}/runs/{run_id}/cancel/`	Cancel a running job execution
GET	`/accounts/{account_id}/runs/{run_id}/artifacts/`	List artifacts generated by a run (manifest, catalog, etc.)
GET	`/accounts/{account_id}/runs/{run_id}/artifacts/{path}`	Download a specific artifact from a run
GET	`/accounts/{account_id}/environments/`	List all environments in an account
GET	`/accounts/{account_id}/jobs/`	List all jobs configured in an account
GET	`/accounts/{account_id}/jobs/{job_id}/`	Retrieve configuration details for a specific job
PATCH	`/accounts/{account_id}/jobs/{job_id}/`	Update job configuration settings
GET	`/accounts/{account_id}/users/`	List all users with access to an account
GET	`/accounts/{account_id}/projects/{project_id}/repository/`	Get repository connection details for a project
GET	`/accounts/{account_id}/audit-logs/`	Retrieve audit logs for account activity

Code Examples

curl -X POST https://cloud.getdbt.com/api/v2/accounts/12345/jobs/67890/run/ \
  -H 'Authorization: Bearer dbt_api_token_abc123xyz' \
  -H 'Content-Type: application/json' \
  -d '{"cause": "API trigger from automation"}'

const response = await fetch('https://cloud.getdbt.com/api/v2/accounts/12345/runs/98765/', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer dbt_api_token_abc123xyz',
    'Content-Type': 'application/json'
  }
});

const runData = await response.json();
console.log(`Run status: ${runData.data.status}`);
console.log(`Duration: ${runData.data.duration}`);

if (runData.data.status === 'success') {
  console.log('dbt run completed successfully');
}

import requests

headers = {
    'Authorization': 'Bearer dbt_api_token_abc123xyz',
    'Content-Type': 'application/json'
}

# Trigger a dbt job run
response = requests.post(
    'https://cloud.getdbt.com/api/v2/accounts/12345/jobs/67890/run/',
    headers=headers,
    json={'cause': 'Scheduled pipeline execution'}
)

run_data = response.json()
run_id = run_data['data']['id']

# Check run status
status_response = requests.get(
    f'https://cloud.getdbt.com/api/v2/accounts/12345/runs/{run_id}/',
    headers=headers
)

status = status_response.json()['data']['status']
print(f'dbt run {run_id} status: {status}')

Use dbt Cloud from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for dbt Cloud. Paste your dbt Cloud API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls dbt Cloud directly with your credentials — no local install, works on mobile.

trigger_dbt_job Trigger a dbt Cloud job run with optional parameters like git branch or schema override

get_run_status Check the status and results of a dbt run, including model execution details and test results

download_run_artifacts Retrieve artifacts from a dbt run such as manifest.json, catalog.json, or run_results.json for analysis

list_project_models Extract and analyze dbt models from the latest run artifacts to understand data lineage

monitor_job_health Monitor recent job runs for failures, duration anomalies, and test failures across environments

Connect in 60 seconds

Paste your dbt Cloud key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect dbt Cloud to your AI →

dbt Cloud REST API

API Endpoints

Sponsor this page

Code Examples

Use dbt Cloud from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs