---
title: "Retrieve a page of connection overrides which apply in a specific environment."
method: GET
path: "/v1/projects/{projectId}/connections/environment-overrides"
tags: ["Connections"]
---

# Retrieve a page of connection overrides which apply in a specific environment.

`GET /v1/projects/{projectId}/connections/environment-overrides`

## Request

- Base URL: `https://eu1.api.matillion.com/dpc`
- URL: `https://eu1.api.matillion.com/dpc/v1/projects/{projectId}/connections/environment-overrides`
- Auth: HTTP bearer

## Path parameters

- `projectId` string, required

## Query parameters

- `environmentName` string, required
- `page` unknown
- `size` unknown

## Response `200`

Successfully retrieved connection

- EnvironmentConnectionOverrideResponse
  - `authProvider` string: The authentication provider
  - `authType` 'GENERIC_SECRET' | 'CLOUD_PROVIDER_SECRET' | 'OAUTH_USER_TOKENS' | 'OAUTH_AUTHORIZATION_CODE' | 'OAUTH_CLIENT_CRED': The authentication type
  - `connectionOverrides` ConnectionOverrideDetails
    - `connectionProperties` union: Connection properties specific to the platform connection type. For COMPONENT_BASIC connections, this contains secretName and secretKey fields.
      - CloudPlatformCredentialsConnectionProperties: Connection properties for cloud platform credentials connections
        - `credentialSecretName` string: The name of the secret containing the cloud platform credentials
      - ComponentBasicConnectionProperties: Connection properties for component basic connections
        - `secretKey` string: Optional key within the secret
        - `secretName` string, required: The name of the secret
    - `secretsLocation` union: The vault location configuration where secrets are stored
      - AwsVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `region` string
      - AzureVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `vaultName` string
      - DefaultVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
      - GcpVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
        - `gcpProjectId` string
      - MatillionHostedVaultLocation
        - `type` 'AWS_SECRET_MANAGER' | 'AZURE_SECRET_MANAGER' | 'GCP_SECRET_MANAGER' | 'MATILLION_CUSTOMER_VAULT' | 'DEFAULT_SECRET_VAULT'
  - `createdBy` string: The user who created the connection
  - `createdDate` string, date-time: The date and time when the connection was created
  - `name` string: The name of the connection
  - `platformConnectionType` 'DWH' | 'COMPONENT_BASIC' | 'CLOUD_PLATFORM_CREDENTIALS': The platform connection type
  - `projectId` string, uuid: The project ID this connection belongs to

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Connection not found

---

[API](https://skmtc.dev/maia/apis/maia-public-rest-api.md) - [All operations](https://skmtc.dev/maia/apis/maia-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maia/apis/maia-public-rest-api/revisions/6239825f68eb?raw)