---
title: "GET /v1/app-connections"
method: GET
path: "/v1/app-connections"
tags: ["app-connections"]
---

# GET /v1/app-connections

`GET /v1/app-connections`

List app connections

## Query parameters

- `cursor` string
- `projectId` string, required
- `scope` 'PROJECT' | 'PLATFORM'
- `pieceName` string
- `displayName` string
- `status` string[], required
- `limit` number

## Response `200`

Default Response

- object
  - `data` AppConnection[], required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `externalId` string, required
    - `displayName` string, required
    - `type` 'OAUTH2' | 'PLATFORM_OAUTH2' | 'CLOUD_OAUTH2' | 'SECRET_TEXT' | 'BASIC_AUTH' | 'CUSTOM_AUTH' | 'NO_AUTH', required
    - `pieceName` string, required
    - `projectIds` string[], required
    - `platformId` string, nullable
    - `scope` 'PROJECT' | 'PLATFORM', required
    - `status` 'ACTIVE' | 'MISSING' | 'ERROR', required
    - `ownerId` string, nullable
    - `owner` User
      - `id` string, required
      - `email` string, required
      - `firstName` string, required
      - `status` 'ACTIVE' | 'INACTIVE', required
      - `externalId` string, nullable
      - `platformId` string, nullable
      - `platformRole` 'ADMIN' | 'MEMBER' | 'OPERATOR', required
      - `lastName` string, required
      - `created` string, required
      - `updated` string, required
      - `lastActiveDate` string, nullable
      - `imageUrl` string, nullable
    - `metadata` object, nullable
    - `flowIds` string[], nullable
    - `pieceVersion` string, required
    - `preSelectForNewProjects` boolean, required
    - `usingSecretManager` boolean, required
  - `next` string, nullable
  - `previous` string, nullable

---

[API](https://skmtc.dev/activepieces/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/activepieces/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activepieces/activepieces-documentation/revisions/745e4b7f764a/schema)