---
title: "List cloud observation connections"
method: GET
path: "/v1/cloud-connections"
tags: ["Cloud observation"]
---

# List cloud observation connections

`GET /v1/cloud-connections`

## Request

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

Returns the authenticated team's connections excluding disconnected records. Credentials are never returned. Reading does not require administrator access or a paid pool subscription.

## Response `200`

List cloud observation connections

- CloudConnectionList
  - `connections` CloudObservationConnection[], required
    - `id` string, required
    - `provider` 'aws' | 'gcp' | 'azure', required
    - `scope` string, required
    - `config` CloudObservationConfig, required: Account identity and read scope. Fields depend on the provider. Credentials are never returned.
      - `provider` 'aws' | 'gcp' | 'azure', required
      - `name` string, required
      - `role_arn` string
      - `project_id` string
      - `billing_table` string
      - `billing_location` string
      - `billing_scope` string
      - `directory_id` string
      - `subscription_id` string
      - `client_id` string
      - `regions` string[]
    - `state` 'pending' | 'collecting' | 'ready' | 'partial' | 'error', required
    - `last_attempt_at` string, date-time, nullable, required
    - `last_success_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
  - `can_connect` boolean, required: Whether credential storage is configured. This does not confer administrator access or prove guided AWS availability.
  - `collection_interval_minutes` 60, required
  - `connection_limit` 200, required

## Other responses

- `default`: Authentication, administrator access, invalid input, missing records, conflicts, rate limits, credential storage, and transient failures are returned using the stable error and message fields.

---

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