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

# Update dbt configuration

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

## Path parameters

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

## Request body

- object — dbt repository configuration
  - `authMethod` 'ssh' | 'https_token' | 'github_app' — Authentication method for the git repository: "ssh" (deploy key), "https_token" (deploy token or PAT), or "github_app" (GitHub App installation, github.com only). Omit to keep the connected repository's method (SSH for a first-time setup).
  - `autogenRelationships` boolean, required — Automatically generate relationships from dbt
  - `branch` string, required — Git branch name
  - `commitSigningCommitterEmail` string, email — Verified email of the GitHub user that owns the registered signing key (github_app auth only). Omit to leave the stored value unchanged. Must be set together with commitSigningCommitterName.
  - `commitSigningCommitterName` string — Display name written into signed commits (github_app auth only). Omit to leave the stored value unchanged. Must be set together with commitSigningCommitterEmail.
  - `dbtVersion` string, nullable — dbt version to use. Supported: Auto, 1.11, 1.12
  - `enableSemanticLayer` boolean — Enable dbt semantic layer integration
  - `enableVirtualSchemas` boolean, required — Enable virtual schemas from dbt
  - `githubAppInstallationId` string — Numeric GitHub App installation ID. Required when connecting a repository with authMethod "github_app"; may be omitted on updates that keep the connected repository.
  - `projectRootPath` union — Path to dbt project root within repository
    - string
    - ''
  - `rotateKeys` boolean — Rotate SSH deploy keys (ssh auth only)
  - `sshUrl` string, required — Clone URL for the git repository — SSH (git@...) for ssh auth, https:// for https_token or github_app auth
  - `token` string — HTTPS access token (deploy token value, PAT, etc.). Required when connecting a repository with authMethod "https_token"; omit on updates that keep the stored token.

## Response `200`

dbt configuration updated successfully

- 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

## Other responses

- `201` — dbt configuration created successfully
- `400` — Invalid request body or validation error
- `401` — Authentication required
- `403` — Permission denied - connection admin role required
- `404` — Connection not found

---

[API](https://skmtc.net/omniapp/apis/omni-api.md) · [All operations](https://skmtc.net/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omniapp/omni-api/versions/4701f292c621/schema)