> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# App Installations API

> En App Installation repræsenterer én installation af din app på én konto.

En konto installerer en app én gang, uanset hvor mange experiences den tilføjer, så en installation indeholder tilstand, der tilhører kontoen frem for én experience, såsom en synkroniseringsmarkør eller ID'et på den konto, den er knyttet til i et andet system.

Brug App Installations API'et til at [vise de konti, din app er installeret på](https://docs.whop.com/da/api-reference/app-installations/list-app-installations.md), [hente en enkelt](https://docs.whop.com/da/api-reference/app-installations/retrieve-app-installation.md) og [opdatere](https://docs.whop.com/da/api-reference/app-installations/update-app-installation.md) de `metadata` og `external_id`, som din app gemmer på den. En konto kan også vise de apps, der er installeret på den, og en udvikler alle installationer af sin app. Kun appen og dens udvikler kan se `metadata` og `external_id`, og kun appen kan ændre dem.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis App Installations](https://docs.whop.com/da/api-reference/app-installations/list-app-installations.md) | GET `/app_installations` |
| [Hent App Installation](https://docs.whop.com/da/api-reference/app-installations/retrieve-app-installation.md) | GET `/app_installations/{id}` |
| [Opdater App Installation](https://docs.whop.com/da/api-reference/app-installations/update-app-installation.md) | PATCH `/app_installations/{id}` |

## Attributter

**id** `string` *required*

App installation-ID med præfikset `aag_`.

**account** `object` *required*

Kontoen, som appen er installeret på.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

**app** `object` *required*

Den installerede app.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> App-ID med præfikset `app_`.
>
> **developer** `object` *required*
>
> Kontoen, der udvikler appen.
>
> > [accordion] Egenskaber
> >
> > **id** `string` *required*
> >
> > Konto-ID med præfikset `biz_`.
> >
> > **title** `string` *required*
> >
> > Kontoens visningsnavn.
>
> **icon** `object` *required*
>
> App-ikon. Falder tilbage til standard-app-ikonet, når der ikke er uploadet et.
>
> > [accordion] Egenskaber
> >
> > **url** `string` *required*
> >
> > URL til ikonbilledet. Altid til stede — standard-app-ikonet, når der ikke er uploadet et.
>
> **name** `string` *required*
>
> Appens visningsnavn.

**created\_at** `string` *required*

Hvornår appen første gang blev installeret på kontoen, som et ISO 8601-tidsstempel.
Hvis appen installeres igen senere, bevares det oprindelige tidspunkt.

**external\_id** `string | null` *required*

Din apps egen identifikator for denne installation, såsom ID'et på den tilknyttede
konto i et andet system, eller `null`, når ingen er angivet. Højst 255 tegn
og unik på tværs af din apps installationer, så du kan finde en installation
med `GET /app_installations?external_id=`; hvis du angiver en, som en anden installation
allerede har, returneres en `409`. Kun appen og dens udvikler kan se den; for den
konto, appen er installeret på, er den altid `null`.

**metadata** `object | null` *required*

Strengnøgler og -værdier, som din app gemmer om denne installation, såsom en synkroniserings-
markør eller ID'et på den tilknyttede konto i et andet system. Tom, indtil din app
angiver en nøgle, og bevares, hvis kontoen fjerner appen og installerer den igen. Højst
50 nøgler; nøgler er højst 100 tegn og værdier højst 500. Kun
appen kan ændre den. Kun appen og dens udvikler kan se den; for den konto,
appen er installeret på, er den altid `null`.

**requesting\_reauthorization** `boolean` *required*

Om appen nu beder om tilladelser, som kontoen endnu ikke har godkendt.

**updated\_at** `string` *required*

Hvornår installationen sidst blev ændret, såsom en `metadata`-opdatering eller at kontoen
ændrede appens tilladelser, som et ISO 8601-tidsstempel.

```json AppInstallation theme={null}
{
	"id": "aag_T4k8M2p6W9r3Qx",
	"app": {
		"id": "app_Q7m3V9k2X5t8Lp",
		"name": "QuickBooks Sync",
		"icon": {
			"url": "https://assets.whop.com/apps/quickbooks-sync/icon.png"
		},
		"developer": {
			"id": "biz_W3r7N1k5P8q2Hd",
			"title": "Ledgerline Labs"
		}
	},
	"account": {
		"id": "biz_J8n2R5p9T1w4Kx",
		"title": "Acme Bookkeeping"
	},
	"external_id": "acme-store",
	"metadata": {
		"last_synced_at": "2026-10-16T21:00:00Z",
		"quickbooks_realm_id": "9341452712"
	},
	"requesting_reauthorization": false,
	"created_at": "2026-09-02T15:30:00.000Z",
	"updated_at": "2026-10-16T21:00:04.000Z"
}
```


## Related topics

- [List App Installations](https://docs.whop.com/da/api-reference/app-installations/list-app-installations.md)
- [App installation deleted](https://docs.whop.com/da/api-reference/app-installations/app-installation-deleted.md)
- [App installation created](https://docs.whop.com/da/api-reference/app-installations/app-installation-created.md)
