---
title: "Get dbt configuration"
method: GET
path: "/api/v1/connections/{connectionId}/dbt"
tags: ["Connections"]
---

# Get dbt configuration

`GET /api/v1/connections/{connectionId}/dbt`

## Path parameters

- `connectionId` string, uuid, required — Connection ID

## Response `200`

dbt configuration for the connection

- union — dbt configuration response
  - object — dbt repository configuration response
    - `authMethod` 'ssh' | 'https_token' | 'github_app', required — Authentication method for the git repository. "ssh" for deploy key, "https_token" for deploy token/PAT, "github_app" for a GitHub App installation.
    - `autogenRelationships` boolean, required — Whether relationships are auto-generated from dbt
    - `branch` string, required — Git branch name
    - `commitSigningCommitterEmail` string, nullable, required — Verified email of the GitHub user that owns the registered signing key. Null unless a commit signer is configured (github_app auth only).
    - `commitSigningCommitterName` string, nullable, required — Display name written into signed commits. Null unless a commit signer is configured (github_app auth only).
    - `commitSigningPublicKey` string, nullable, required — SSH public key to register as a signing key on the GitHub user that owns commitSigningCommitterEmail, so commits show as Verified. Null for non-github_app auth.
    - `dbtVersion` string, required — dbt version being used
    - `enableSemanticLayer` boolean, required — Whether the dbt semantic layer integration is enabled
    - `enableVirtualSchemas` boolean, required — Whether virtual schemas are enabled
    - `githubAppInstallationId` string, nullable, required — GitHub App installation ID. Null for non-github_app auth.
    - `projectRootPath` string, nullable, required — Path to dbt project root
    - `sshUrl` string, required — Clone URL for the git repository — SSH (git@...) for ssh auth, https:// for https_token or github_app auth
    - `supportsDbt` true, required — Indicates dbt is supported and configured
  - object — Response when dbt is not configured
    - `message` string, required — Message explaining dbt status
    - `supportsDbt` boolean, required — Whether the connection dialect supports dbt

## Other responses

- `401` — Authentication required
- `403` — Permission denied - connection admin role required
- `404` — Connection not found

## Changes

- **2026-07-26** `f65b6ea0a62f` — 5 info
  - added the required property `anyOf[subschema #1: DbtConfiguredResponse]/authMethod` to the response with the `200` status
  - added the required property `anyOf[subschema #1: DbtConfiguredResponse]/commitSigningCommitterEmail` to the response with the `200` status
  - added the required property `anyOf[subschema #1: DbtConfiguredResponse]/commitSigningCommitterName` to the response with the `200` status
  - added the required property `anyOf[subschema #1: DbtConfiguredResponse]/commitSigningPublicKey` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/connections/:connectionId/dbt/get.md)

---

[API](https://skmtc.dev/omniapp/apis/omni-api.md) · [All operations](https://skmtc.dev/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omniapp/omni-api/revisions/2ed3f36eff42/schema)