v4

latestOpenAPI 3.1.02026-08-01207318738.7 KB

Connections

Create dbt environment

Create a new dbt environment for a connection.

post/api/v1/connections/{connectionId}/dbt/environments

connectionIdstring uuid required

Connection ID

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

Connection ID

isDeferralEnabledboolean

Whether to enable dbt deferral for this environment. Ignored (forced to false) for the default (production) environment.

namestring required

Environment name

ownerIdstring nullable

User ID of the environment owner. Used to mark development environments belonging to a specific user.

targetDatabasestring nullable

Target database override

targetNamestring nullable

Target name override

targetRolestring nullable

Target role override

targetSchemastring required

Target schema for this environment

{
  "name": "PR_1111_Expose",
  "targetDatabase": "analytics_dev",
  "targetSchema": "PR_1111_Expose"
}

dbt environment created successfully

idstring uuid required

Unique environment identifier

isDefaultEnvironmentboolean required

Whether this is the default environment

isDeferralEnabledboolean required

Whether dbt deferral is enabled for this environment. Always false for the default (production) environment — the backend rejects enabling it there.

namestring required

Environment name

ownerIdstring nullable required

User ID of the environment owner, or null if not a personal environment

targetDatabasestring nullable required

Target database override

targetNamestring nullable required

Target name override

targetRolestring nullable required

Target role override

targetSchemastring required

Target schema