Manage connections

Programmatically add, list, and remove cloud infrastructure connections.

List connections

bash

GET /api/v1/connections
Authorization: Bearer <token>
X-Tenant-Slug: my-company

json

[
  {
    "id": "conn_abc123",
    "alias": "Production AWS",
    "provider": "aws",
    "status": "active",
    "last_scan_at": "2026-04-12T06:00:00Z"
  },
  {
    "id": "conn_def456",
    "alias": "EKS Cluster",
    "provider": "kubernetes",
    "status": "active",
    "last_scan_at": "2026-04-12T06:00:00Z"
  }
]

Supported providers

awsAmazon Web Services

azureMicrosoft Azure

gcpGoogle Cloud Platform

kubernetesKubernetes

linuxLinux / SSH

windowsWindows Server

dockerDocker

Connection status values

activeConnected and ready to scan

pendingConnection test in progress

failedConnection test failed — check credentials

disconnectedConnection manually disconnected