---
title: "List dbt environments"
method: GET
path: "/v1/connections/{connectionId}/dbt/environments"
tags: ["dbt"]
---

# List dbt environments

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

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/connections/{connectionId}/dbt/environments`
- Auth: HTTP bearer

<Note>
  This endpoint requires **Restricted Querier** permissions or higher on the connection.
</Note>

Retrieves a list of all dbt environments configured for the specified connection.

## Path parameters

- `connectionId` string, uuid, required

## Response `200`

List of dbt environments retrieved successfully

- DbtEnvironment[]
  - `id` string, uuid: Unique identifier of the dbt environment
  - `name` string: The name of the dbt environment
  - `isDefaultEnvironment` boolean: Whether this is the default environment
  - `isDeferralEnabled` boolean: Whether deferral is enabled for this environment. Ignored (forced to `false`) for the default (production) environment.
  - `ownerId` string, uuid, nullable: The organization membership ID of the owner of the dbt environment, or null
  - `targetDatabase` string, nullable: Target database override
  - `targetName` string, nullable: Target name override
  - `targetRole` string, nullable: Target role override
  - `targetSchema` string: Target schema for the environment
  - `variables` object[]: Environment variables
    - `id` string, uuid: Variable identifier
    - `name` string: Variable name
    - `value` string, nullable: Variable value. If `isSecret: true`, this value will be `null` in responses to protect sensitive information.
    - `isSecret` boolean: Whether the variable value is secret.

## Other responses

- `401`: Missing or invalid authentication
- `403`: Forbidden Possible causes: - Insufficient permissions
- `404`: Connection not found
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)