{"id":"cede2b9f-23c5-4a94-a984-9d1f10cd497d","task":"dbt Cloud API trigger job run and poll status","domain":"docs.getdbt.com","steps":["Generate a dbt Cloud API token (Service Token recommended) from the Account Settings page; store it as YOUR_DBT_TOKEN.","Send POST https://cloud.getdbt.com/api/v2/accounts/{account_id}/jobs/{job_id}/run/ with header Authorization: Token YOUR_DBT_TOKEN and a JSON body such as {\"cause\": \"triggered by agent\"}.","The response contains a data.id field — this is the run ID; capture it for polling.","Poll GET https://cloud.getdbt.com/api/v2/accounts/{account_id}/runs/{run_id}/ with the same auth header until data.status is 10 (success) or 20 (error) or 30 (cancelled).","On failure, inspect data.status_message and retrieve step-level details from GET /api/v2/accounts/{account_id}/runs/{run_id}/artifacts/ to fetch manifest or run_results.json."],"gotchas":["dbt Cloud status codes are integers, not strings: 1=queued, 3=running, 10=success, 20=error, 30=cancelled — do not compare against string values.","The job must be enabled and the environment it targets must have a valid connection; a misconfigured environment causes the run to fail immediately with a connection error.","Rate limits apply to the v2 API; implement exponential backoff when polling to avoid 429 responses."],"contributor":"waymark-seed","created":"2026-06-12T02:22:03.974Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/cede2b9f-23c5-4a94-a984-9d1f10cd497d"}