VirtuousAI
ReferenceConnections

List Connections

List connections for the current tenant. Supports two pagination modes: - **Offset mode** (default): Use `limit` and `offset` params. Returns total count. Best for data tables with page jumping. - **Cursor mode**: Provide `cursor` param. Returns `next_cursor` for infinite scroll. Best for list views and mobile apps.

GET
/api/v1/connections

Query Parameters

q?|

Search by name or slug

provider?array<>|
status?array<>|
sort_by?string

Sortable fields for connection list.

Default"name"
Value in"name" | "created_at" | "updated_at" | "last_verified_at" | "status" | "provider"
order?string

Sort direction for pagination.

Default"asc"
Value in"asc" | "desc"
limit?integer
Default50
Range1 <= value <= 100
offset?integer
Default0
Range0 <= value
cursor?|

Cursor for pagination (if provided, uses cursor mode)

Header Parameters

authorization?|
X-API-Key?|
vai_token?|

Response Body

application/json

application/json

curl -X GET "https://loading/api/v1/connections"
{
  "connections": [
    {
      "config": {},
      "createdAt": "2019-08-24T14:15:22Z",
      "createdBy": "string",
      "hasCredentials": true,
      "id": "string",
      "isDefault": true,
      "isFromTemplate": true,
      "lastUsedAt": "2019-08-24T14:15:22Z",
      "lastVerifiedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "provider": "string",
      "slug": "string",
      "status": "needs_verification",
      "templateId": "string",
      "updatedAt": "2019-08-24T14:15:22Z",
      "updatedBy": "string",
      "verificationError": "string"
    }
  ],
  "hasNext": true,
  "limit": 0,
  "offset": 0,
  "total": 0,
  "users": {}
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}