v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

Connections

Update dbt configuration

put/api/v1/connections/{connectionId}/dbt

Path parameters

connectionIdstring uuid required

Connection ID

Example:550e8400-e29b-41d4-a716-446655440000

Connection ID

Request body

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).

autogenRelationshipsboolean required

Automatically generate relationships from dbt

branchstring required

Git branch name

commitSigningCommitterEmailstring 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.

commitSigningCommitterNamestring

Display name written into signed commits (github_app auth only). Omit to leave the stored value unchanged. Must be set together with commitSigningCommitterEmail.

dbtVersionstring nullable

dbt version to use. Supported: Auto, 1.11, 1.12

enableSemanticLayerboolean

Enable dbt semantic layer integration

enableVirtualSchemasboolean required

Enable virtual schemas from dbt

githubAppInstallationIdstring

Numeric GitHub App installation ID. Required when connecting a repository with authMethod "github_app"; may be omitted on updates that keep the connected repository.

rotateKeysboolean

Rotate SSH deploy keys (ssh auth only)

sshUrlstring required

Clone URL for the git repository — SSH (git@...) for ssh auth, https:// for https_token or github_app auth

tokenstring

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.

Example request

{
  "authMethod": "ssh",
  "autogenRelationships": true,
  "branch": "main",
  "commitSigningCommitterEmail": "omni-bot@example.com",
  "commitSigningCommitterName": "Omni Bot",
  "dbtVersion": "1.11",
  "githubAppInstallationId": "12345678",
  "sshUrl": "git@github.com:org/repo.git"
}

Response

dbt configuration updated successfully

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.

autogenRelationshipsboolean required

Whether relationships are auto-generated from dbt

branchstring required

Git branch name

commitSigningCommitterEmailstring 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).

commitSigningCommitterNamestring nullable required

Display name written into signed commits. Null unless a commit signer is configured (github_app auth only).

commitSigningPublicKeystring 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.

dbtVersionstring required

dbt version being used

enableSemanticLayerboolean required

Whether the dbt semantic layer integration is enabled

enableVirtualSchemasboolean required

Whether virtual schemas are enabled

githubAppInstallationIdstring nullable required

GitHub App installation ID. Null for non-github_app auth.

projectRootPathstring nullable required

Path to dbt project root

sshUrlstring required

Clone URL for the git repository — SSH (git@...) for ssh auth, https:// for https_token or github_app auth

supportsDbttrue required

Indicates dbt is supported and configured

Example response

{
  "authMethod": "ssh",
  "autogenRelationships": true,
  "branch": "main",
  "commitSigningCommitterEmail": "omni-bot@example.com",
  "commitSigningCommitterName": "Omni Bot",
  "dbtVersion": "Auto",
  "githubAppInstallationId": "12345678",
  "projectRootPath": "dbt_project",
  "sshUrl": "git@github.com:org/repo.git",
  "supportsDbt": true
}