Skip to main content

dbt Cloud Integration API

dbt Cloud webhook receiver, integration health dashboard, quality gate, and lineage edge creation.

Endpoints Overview

MethodEndpointDescription
POST/integrations/dbt-cloud/webhookReceive dbt Cloud webhook
GET/spaces/{slug}/integration-healthIntegration health
GET/spaces/{slug}/quality-gateQuality gate check
POST/spaces/{slug}/lineage-edgesCreate lineage edge

Receive dbt Cloud Webhook

POST /integrations/dbt-cloud/webhook?connector_id=...&space_id=...

Receives inbound dbt Cloud run-completed events. Validates the HMAC-SHA256 signature and delegates to the sync service.


Integration Health

GET /spaces/{slug}/integration-health?days=30

Returns aggregated health metrics: total events, success rate, and per-integration-type breakdowns.


Quality Gate

GET /spaces/{slug}/quality-gate?product_slug=...&threshold=100

Evaluates whether a product passes its quality gate (ratio of passing checks vs. threshold).


Create Lineage Edge

POST /spaces/{slug}/lineage-edges
{
"source_product_slug": "raw-events",
"target_product_slug": "enriched-events",
"edge_type": "manual"
}