API
POST /api/webhooks/dbt
Authorization: Bearer DBT_WEBHOOK_SECRET. Body: raw run_results.json. Optional CI query params: repo, sha, pr, run_id, ref. Response includes passed, fixFirst, and ci.markdown for PR comments.
Steps
1. Configure the secret
Set DBT_WEBHOOK_SECRET (or MONITOR_API_KEY) in Vectornosis and CI.
2. Point the webhook
URL: https://www.vectornosis.com/api/webhooks/dbt — add ?notify=1 for calm Slack/email.
3. POST run_results.json
Include CI metadata via query or x-vectordata-* headers. Expect 200 with ci.markdown.
4. PR Data CI
Prefer the GitHub Action — it posts Check Runs and PR comments automatically.
Verify
- passed=false when models/tests fail
- ci.markdown includes Fix first
- Invalid secret returns 401