> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# List connections

`GET /api/v1/agentkit/connection`

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](https://docs.scalekit.com/agentkit/reference/connections/get-a-connection/) for one connection's settings.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page_size` | integer | No | The number of connections to return, up to 100. Defaults to 10. |
| `page_token` | string | No | The `next_page_token` from the previous response, to get the next page. Leave it out for the first page. |
| `provider` | string | No | Return only connections for this connector, by its identifier, such as `GMAIL`. A connection's `provider` field holds the same value. |
| `query` | string | No | Return connections whose name, connector or connector display name contains this text, such as `gmail`. At least 3 characters. |

**Response (200)**

| Name | Type | Description |
| --- | --- | --- |
| `connections` | array of object | The connections on this page, newest first. |
| `connections.auth_mode` | string (enum) | `USER`: each user authorizes their own account. `ORG_WIDE`: one admin-authorized account is shared. One of: `USER`, `ORG_WIDE`. |
| `connections.connection_name` | string | The connection's name. |
| `connections.create_time` | string | When the connection was created. |
| `connections.id` | string | The connection's ID. |
| `connections.provider` | string | The connector this connection uses, such as `GMAIL`. |
| `connections.type` | string (enum) | How users authenticate to the app, such as `OAUTH`. One of: `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. |

**Errors**

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

**Request**

```bash
curl -sS -G -X GET \
  "$SCALEKIT_ENVIRONMENT_URL/api/v1/agentkit/connection" \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "provider=GMAIL" \
  --data-urlencode "page_size=10"
```

**Response**

```json
{
  "connections": [
    {
      "id": "conn_70219645518265104",
      "connection_name": "gmail-work",
      "provider": "GMAIL",
      "type": "OAUTH",
      "auth_mode": "USER",
      "create_time": "2026-10-02T14:30:00Z"
    },
    {
      "id": "conn_70219645518265377",
      "connection_name": "gmail-support",
      "provider": "GMAIL",
      "type": "OAUTH",
      "auth_mode": "USER",
      "create_time": "2026-09-28T09:12:00Z"
    }
  ],
  "next_page_token": "",
  "prev_page_token": "",
  "total_size": 2
}
```

**Python SDK:** `scalekit_client.actions.list_app_connections`

Lists connections, newest first. Filter by connector with `provider`, or search by name with `query`.

```python
scalekit_client.actions.list_app_connections(
    provider: Optional[str] = None,
    query: Optional[str] = None,
    page_size: Optional[int] = None,
    page_token: Optional[str] = None,
) -> AgentKitConnectionList
```

Example:

```python
result = scalekit_client.actions.list_app_connections(
    provider="GMAIL",
    page_size=10,
)
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | `Optional[str]` | No | Return only connections for this connector, by its identifier, such as `GMAIL`. A connection's `provider` field holds the same value. |
| `query` | `Optional[str]` | No | Return connections whose name, connector or connector display name contains this text, such as `gmail`. At least 3 characters. |
| `page_size` | `Optional[int]` | No | The number of connections to return, up to 100. Defaults to 10. |
| `page_token` | `Optional[str]` | No | The `next_page_token` from the previous response, to get the next page. Leave it out for the first page. |

Returns `AgentKitConnectionList`.

**Node.js SDK:** `scalekit.actions.listAppConnections`

Lists connections, newest first. Filter by connector with `provider`, or search by name with `query`.

```ts
scalekit.actions.listAppConnections(
  params?: {
    provider?: string;
    query?: string;
    pageSize?: number;
    pageToken?: string;
  },
): Promise<ListAppConnectionsResponse>
```

Example:

```ts
const result = await scalekit.actions.listAppConnections({
  provider: "GMAIL",
  pageSize: 10,
});
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `provider` | `string` | No | Return only connections for this connector, by its identifier, such as `GMAIL`. A connection's `provider` field holds the same value. |
| `query` | `string` | No | Return connections whose name, connector or connector display name contains this text, such as `gmail`. At least 3 characters. |
| `pageSize` | `number` | No | The number of connections to return, up to 100. Defaults to 10. |
| `pageToken` | `string` | No | The `nextPageToken` from the previous response, to get the next page. Leave it out for the first page. |

Returns `Promise<ListAppConnectionsResponse>`.


Part of [Connections](https://docs.scalekit.com/agentkit/reference/connections/) in the [AgentKit API reference](https://docs.scalekit.com/agentkit/reference/). Authentication: https://docs.scalekit.com/agentkit/reference/authentication.md. Errors and rate limits: https://docs.scalekit.com/agentkit/reference/errors.md. Pagination: https://docs.scalekit.com/agentkit/reference/pagination.md


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |