---
title: "List connections"
method: GET
path: "/api/v1/agentkit/connection"
tags: ["App Connections"]
---

# List connections

`GET /api/v1/agentkit/connection`

## Request

- Base URL: `https://$SCALEKIT_ENVIRONMENT_URL`
- URL: `https://$SCALEKIT_ENVIRONMENT_URL/api/v1/agentkit/connection`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://$SCALEKIT_ENVIRONMENT_URL/oauth/token`
- TypeScript: <https://skmtc.dev/scalekit/apis/scalekit-api-reference/docs/api/v1/agentkit/connection/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the connections in the environment, newest first, without their settings. Filter by connector, or search by name. Use it to find a connection's name or ID, or to check whether a connector already has a connection; call [Get a connection](/agentkit/reference/connections/get-a-connection/) for one connection's settings.

## Query parameters

- `page_size` integer
- `page_token` string
- `provider` string
- `query` string

## Response `200`

The connections on this page, with the token for the next page.

- ConnectionsListAppConnectionSummariesResponse
  - `connections` ConnectionsAppConnectionSummary[]: The connections on this page, newest first.
    - `auth_mode` 'USER' | 'ORG_WIDE': How users authorize the connection: `USER` or `ORG_WIDE`.
    - `connection_name` string: The connection's name.
    - `create_time` string, date-time: When the connection was created.
    - `id` string: The connection's ID.
    - `provider` string: The connector this connection uses, such as `GMAIL`.
    - `type` 'OIDC' | 'SAML' | 'PASSWORD' | 'OAUTH' | 'PASSWORDLESS' | 'BASIC' | 'BEARER' | 'API_KEY' | 'WEBAUTHN' | 'OAUTH_M2M' | 'TRELLO_OAUTH1' | 'GOOGLE_DWD' | 'TRUSTED_IDP' | 'SMART_FHIR' | 'NO_AUTH'
  - `next_page_token` string: Pass as `page_token` to get the next page. Empty on the last page.
  - `prev_page_token` string: Pass as `page_token` to get the previous page.
  - `total_size` integer: The number of connections that match.

## Other responses

- `400`: Invalid request - for example, `query` is shorter than 3 characters.
- `401`: Authentication required - missing or invalid access token

## Changes

- **2026-10-30** `f6c5d8349d4a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scalekit/apis/scalekit-api-reference/changes/api/v1/agentkit/connection/get.md)

---

[API](https://skmtc.dev/scalekit/apis/scalekit-api-reference.md) - [All operations](https://skmtc.dev/scalekit/apis/scalekit-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/scalekit/apis/scalekit-api-reference/revisions/f47f1022d844?raw)