Skip to main content
GET
List AI gateways
Returns your tenant’s gateways, newest first, with agent_count on each. Gateways are not environment-partitioned: the same objects come back whether you authenticate with a live or a test credential. The live/test distinction lives in the phantom token — see Sandbox and phantom-token environments.
The dashboard twin. The same operation exists on the admin host as GET /admin/ai-gateway, session-authenticated with an X-Tenant-ID header and an owner/admin role. That is what the dashboard itself calls. Prefer the /v1 operation above for anything you write: it is the surface the five SDKs, the Postman collection and this spec cover.

Authorizations

Authorization
string
header
required

OAuth 2.1 authentication — recommended for new integrations. Access tokens (kc_ prefix) are minted at the root-host token endpoint https://api.knoxcall.com/oauth/token and passed as Authorization: Bearer <access_token>. Public clients must use PKCE with the authorization_code grant; confidential clients may use client_credentials. The first-party SDKs and the knoxcall login CLI handle token minting, caching, refresh, and DPoP for you.

Query Parameters

page
integer
default:1

Page number for pagination. Clamped server-side so the derived offset never exceeds 100,000 rows -- the effective maximum is floor(100000 / per_page) + 1, i.e. 1,001 at per_page=100. A larger value returns that last page, and meta.page reports it.

Required range: x >= 1
per_page
integer
default:20

Number of items per page (max 100).

Required range: 1 <= x <= 100

Response

A paginated list of AI gateways.

data
object[]
meta
object

Pagination metadata for list endpoints.