---
title: "List external connection metadata"
method: GET
path: "/v1/connections"
tags: ["Connections"]
---

# List external connection metadata

`GET /v1/connections`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/connections`
- Auth: HTTP bearer

## Response `200`

Success

- object
  - `connections` Connection[], required
    - `name` string, required
    - `kind` 'postgres' | 'neon' | 'supabase' | 'wandb', required
    - `scope` 'read' | 'write' | 'readwrite', required: Defaults to read for database kinds and write for wandb.
    - `region` string
    - `branch` string
    - `entity` string
    - `project` string
    - `live_mode` boolean, required: Requires a current team administrator and wandb write or readwrite scope.
    - `id` string, required
    - `secret_id` string, required
    - `secret_version` integer, required
    - `egress_hosts` string[], required
    - `verified_at` string, date-time, required
    - `created_at` string, date-time, required
    - `created_by` string, required

## Other responses

- `default`: Connection operation rejected. Errors never include credential values.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)
