---
title: "Get App Instance"
method: GET
path: "/v2/app-instances/{id}"
tags: ["App Instance API"]
---

# Get App Instance

`GET /v2/app-instances/{id}`

Get a specific app instance by ID.

## Path parameters

- `id` string, required — The ID of the app instance.

## Response `200`

Success

- SvflowPublicapiGetAppInstanceResponse
  - `data` SvflowPubapimodelsAppInstance — Configuration object. **Set exactly ONE of:** customServiceId, service
    - `customServiceId` string — **Option: custom_service_id** — The ID of the custom service (for custom apps).
    - `service` string — **Option: service** — The service identifier (for built-in services like "github", "okta", "aws").
    - `id` string — The ID of the app instance.
    - `teamId` string — The ID of the Serval team that owns the app instance. For instances returned by ListAppInstances because they are shared with the requesting team, this is the owning team's ID and will differ from the request team_id.
    - `externalServiceInstanceId` string — The external service instance ID (e.g., GitHub org name, Okta domain, AWS account ID).
    - `name` string — The name of the app instance.
    - `accessRequestsEnabled` boolean — Whether access requests are enabled for the app instance.
    - `defaultAccessPolicyId` string, nullable — The default access policy for the app instance.
    - `customServiceName` string — The display name of the custom service (only set when service_type is custom_service_id).
    - `tagIds` string[] — IDs of the tags currently attached to this app instance.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)