Overview
The dbt Platform connection stores the API details used by the Execute dbt Platform Job flow: the regional API host, your account ID, and an encrypted API token. Create it once and reuse it for every dbt Platform job you trigger from Etlworks.
Available in Etlworks 9.9.9 and later.
Connection parameters
- API Host: the exact host shown in your dbt Platform URL, without /api or another path (default https://cloud.getdbt.com). Regional and multi-cell hosts are supported.
- Account ID: your numeric dbt Platform account ID.
-
Token Type:
- service — a least-privilege service token, recommended for production. Sent as Authorization: Token.
- personal — a personal access token, supported for development. Sent as Authorization: Bearer.
- API Token: the token value, stored encrypted. It must be authorized to read jobs and runs and to trigger and cancel the jobs you plan to run.
- Default Project ID and Default Environment ID: optional numeric IDs retained for validation and future job discovery.
- Default Job ID: optional job used when a dbt Platform flow does not provide its own Job ID.
Testing the connection
Test Connection performs a bounded one-row job query against the API to verify the host, account, and token. It does not start a job.
Scope
Etlworks triggers and observes existing deployment jobs. It does not create or edit dbt Platform projects, environments, jobs, or schedules — manage those in dbt Platform.