API referenceConnections

List connections

GET
/v2/connections

Connected channels, newest first, each with what it can send over the API right now (this workspace’s rollout flags resolved). WhatsApp Web connections carry a warning about account bans.

Authorization

ApiKey
headerAuthorizationBearer <token>

An API key from Developers → API keys: Authorization: Bearer gauge_live_… (or pulse_k_live_…).

Query Parameters

limit?integer

Page size, 1–100.

Range1 <= value <= 100
Default25
after?string

A nextCursor from the previous page. Opaque.

before?string

A prevCursor, to page back. Opaque. Not with after.

Header Parameters

Gauge-Version?string

A dated version. Default 2026-10-21.

Response Body

A page of connections.

application/json
  1. response

A cursor page over (created_at, id). Every list returns this shape.

data*array<>
nextCursor*|

Pass as after for the next page; null on the last page.

prevCursor*|

Pass as before for the previous page; null on the first page.

Example Request
curl -X GET 'https://app.gauge.chat/backend/v2/connections'
Example Response
{  "nextCursor": "string",  "prevCursor": "string",  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "kind": "string",      "displayName": "string",      "status": "string",      "createdAt": "string",      "capabilities": {        "sendText": true,        "sendMedia": true,        "sendTemplates": true,        "sendInteractive": true,        "quotedReplies": true,        "startConversations": true,        "broadcast": true,        "delivery": "immediate"      },      "flags": {        "property1": true,        "property2": true      },      "warning": {        "code": "whatsapp_web_ban_risk",        "message": "string"      },      "limits": {        "sessionWindowHours": 0,        "templateRequiredOutsideWindow": true,        "sendCaps": {          "perMinute": 0,          "perDay": 0,          "warmupTier": 0        },        "maxMediaBytes": 0      }    }  ]}