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

# GET /v1/app-connections/{id}

`GET /v1/app-connections/{id}`

Get an app connection by id

## Path parameters

- `id` string, required

## Response `200`

Default Response

- AppConnection
  - `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

---

[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)
