Connections

Count the tenant's connections (no rows)

The tenant's connection histogram, computed server-side in one grouped query. Use this instead of paging GET /connections when you only need totals (dashboards, quota meters, per-application domain counts). The numbers are exact regardless of how many connections the tenant has.

by_status carries only statuses that actually occur: an absent key means zero, never "unknown". Optional ?app_id= / ?status= narrow the aggregate exactly as they narrow the list; a status outside the enum is rejected with 400.

API key only: this is a tenant-wide aggregate, so a per-application widget JWT cannot read it.

get/connections:count

Request

  • Base URL: https://api.customdomain.ai/v1
  • URL: https://api.customdomain.ai/v1/connections:count
  • Auth: HTTP bearer

Query parameters

app_idstring
status'pending' | 'propagating' | 'live' | 'failed'

Response

Connection counts

totalinteger required
by_statusobject required

Changes

No recorded changes to this operation across all 1 revision of this API.