> ## 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.

# Upload filer direkte

> Upload filer til Whop-lageret med forhåndssignerede uploads i én del og multipart-uploads

Uploads til Whop går **direkte til lageret**. Når du kalder [Create File](https://docs.whop.com/da/api-reference/files/create-file.md), modtager Whop ikke dine bytes via API'et. I stedet opretter Whop en filpost og returnerer en **forhåndssigneret upload-URL**, som du selv sender bytes til med `PUT`. Filen kan bruges, så snart disse bytes er landet i Whops lager.

Dette er det rå totrinsforløb bag SDK'ets metoder `files.create` og `files.retrieve`. Brug det, når du uploader fra browseren (så bytes aldrig rører din server) eller arbejder i et sprog uden SDK. Det er også sådan, du sender filer, der er store nok til at kræve multipart.

> [!NOTE]
>
> `/files`-endpoints kræver API-version `2026-08-21-1` eller nyere. Hver forespørgsel nedenfor fastlåser den med `Api-Version-Date`-headeren. Se [API-versioner](https://docs.whop.com/da/developer/api/versioning.md).

## Uploadens livscyklus

Hver upload består af tre trin, uanset om den er i én del eller mange:

1. **Opret** filposten → Whop returnerer en forhåndssigneret destination, og filen starter som `pending`.
2. **Upload** bytes direkte til de forhåndssignerede URL'er.
3. **Poll** [Retrieve File](https://docs.whop.com/da/api-reference/files/retrieve-file.md), indtil `upload_status` er `ready` — så er `url` og `size` udfyldt, og filens ID kan vedhæftes overalt, hvor Whop accepterer et dokument.

En fils `url` og `size` forbliver `null`, indtil behandlingen er færdig. `upload_status` går fra `pending` → `processing` → `ready` (eller `failed`).

## Upload i én del

Brug en enkelt `PUT` til alt under et par hundrede megabyte.

**1. Opret filen**

Send `filename` og eventuelt en `visibility` (`private` som standard). Svarets `upload_url` er der, hvor bytes skal sendes hen, og `upload_headers` er de headere, du skal sende med dem.

```bash theme={null}
curl https://api.whop.com/api/v1/files \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "terms.pdf", "visibility": "private" }'
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "terms.pdf",
  "content_type": "application/pdf",
  "size": null,
  "url": null,
  "removed_by_moderation": false,
  "upload_status": "pending",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null,
  "upload_url": "https://upload.whop.com/uploads/...&signature=...",
  "upload_headers": { "Content-Type": "application/pdf" },
  "multipart_upload_id": null,
  "multipart_upload_urls": null,
  "multipart_chunk_size": null
}
```

**2. Upload bytes**

Send filens indhold med `PUT` til `upload_url`, og send alle headere fra `upload_headers` med. Denne forespørgsel går direkte til Whops fillager, **ikke** til `api.whop.com`, og har ingen Whop `Authorization`-header — legitimationsoplysningerne er indbygget i den forhåndssignerede URL.

```bash theme={null}
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary @terms.pdf
```

> [!WARNING]
>
> Den forhåndssignerede URL udløber én time efter, at den er udstedt. Opret filen lige før du uploader, og anmod om en ny, hvis en `PUT` mislykkes med `403` efter en lang forsinkelse. URL'er til multipart-dele udløber tidligere, efter 15 minutter.

**3. Poll, indtil den er klar**

Hent filen via dens ID, indtil `upload_status` bliver `ready`. Feltet `url` indeholder så et downloadlink: en permanent CDN-URL, når filen er `public`, eller en signeret URL, der udløber, når den er `private`.

```bash theme={null}
curl https://api.whop.com/api/v1/files/file_XXXXXXXX \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1"
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "terms.pdf",
  "content_type": "application/pdf",
  "size": 82345,
  "url": "https://files.whop.com/...&signature=...",
  "removed_by_moderation": false,
  "upload_status": "ready",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null
}
```

## Multipart-upload

Store filer uploades i dele. Whop returnerer én forhåndssigneret URL pr. del. Du uploader dem (eventuelt parallelt) og beder derefter Whop om at samle dem.

Multipart er **påkrævet over 5 GB**, da en enkelt upload-forespørgsel ikke kan overstige det. Det er også en god idé over \~100 MB, hvor én lang upload er skrøbelig. Filen skal være større end 5 MB, da alle dele undtagen den sidste skal være mindst 5 MB.

**1. Opret filen med multipart aktiveret**

Angiv `multipart: true` og den samlede `byte_size`, så Whop ved, hvor mange forhåndssignerede del-URL'er der skal returneres. Svaret indeholder et `multipart_upload_id`, én forhåndssigneret `url` pr. `part_number` og `multipart_chunk_size` (bytes), som hver del undtagen den sidste skal have.

```bash theme={null}
curl https://api.whop.com/api/v1/files \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{ "filename": "release.mp4", "visibility": "private", "multipart": true, "byte_size": 12582912 }'
```

```json theme={null}
{
  "object": "file",
  "id": "file_XXXXXXXX",
  "filename": "release.mp4",
  "content_type": "video/mp4",
  "size": null,
  "url": null,
  "removed_by_moderation": false,
  "upload_status": "pending",
  "visibility": "private",
  "created_at": "2026-08-21T18:24:00.000Z",
  "width": null,
  "height": null,
  "blurhash": null,
  "duration_seconds": null,
  "waveform_url": null,
  "upload_url": null,
  "upload_headers": {},
  "multipart_upload_id": "2~aBcD1234...",
  "multipart_upload_urls": [
    { "part_number": 1, "url": "https://upload.whop.com/...&part_number=1&signature=..." },
    { "part_number": 2, "url": "https://upload.whop.com/...&part_number=2&signature=..." },
    { "part_number": 3, "url": "https://upload.whop.com/...&part_number=3&signature=..." }
  ],
  "multipart_chunk_size": 5242880
}
```

> [!NOTE]
>
> Multipart-uploads understøtter højst **10.000 dele** på hver 5 MB — omkring 50 GB. En `byte_size`, der ville kræve flere dele, afvises med en `400`.

**2. Upload hver del, og gem dens ETag**

Del filen op i bidder på `multipart_chunk_size` bytes (den sidste del må være mindre), og send hver bid med `PUT` til den tilsvarende dels `url`. Hvert upload-svar returnerer en **`ETag`-header** — gem den sammen med `part_number`, da du skal bruge begge for at afslutte.

```javascript theme={null}
import { readFile } from "node:fs/promises";

const bytes = await readFile("./release.mp4");
const chunkSize = created.multipart_chunk_size;

const parts = await Promise.all(
  created.multipart_upload_urls.map(async ({ part_number, url }) => {
    const start = (part_number - 1) * chunkSize;
    const chunk = bytes.subarray(start, start + chunkSize);

    const res = await fetch(url, { method: "PUT", body: chunk });
    if (!res.ok) throw new Error(`Part ${part_number} failed: ${res.status}`);

    // The ETag header comes back quoted, e.g. "\"abc123\"" — send it as-is.
    return { part_number, etag: res.headers.get("etag") };
  }),
);
```

**3. Fuldfør uploaden**

Send `multipart_upload_id` og hver dels `part_number` + `etag` tilbage til [Complete File Multipart Upload](https://docs.whop.com/da/api-reference/files/complete-file-multipart-upload.md). Whop samler delene til den endelige fil.

```bash theme={null}
curl https://api.whop.com/api/v1/files/file_XXXXXXXX/complete \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1" \
  -H "Content-Type: application/json" \
  -d '{
    "multipart_upload_id": "2~aBcD1234...",
    "multipart_parts": [
      { "part_number": 1, "etag": "\"5eb63bbbe01eeed093cb22bb8f5acdc3\"" },
      { "part_number": 2, "etag": "\"9e107d9d372bb6826bd81d3542a419d6\"" },
      { "part_number": 3, "etag": "\"e4d909c290d0fb1ca068ffaddf22cbd0\"" }
    ]
  }'
```

> [!WARNING]
>
> Alle dele skal listes i rækkefølge med præcis den `ETag`, der blev returneret, da du uploadede dem. Et ukendt `multipart_upload_id` eller en `ETag`, der ikke matcher, returneres som en `400` — upload den pågældende del igen, og fuldfør igen.

**4. Poll, indtil den er klar**

Ligesom ved uploads i én del skal du hente filen, indtil `upload_status` er `ready`. ID'et er så klar til at blive vedhæftet.

## Valg af synlighed

Du angiver `visibility`, når filen oprettes, og kan ikke ændre den bagefter:

| Synlighed | Den `url`, du får | Bruges til |
| - | - | - |
| `private` (standard) | Signeret URL, der udløber | Juridiske dokumenter, beviser i tvister, brugeruploads |
| `public` | Permanent, usigneret CDN-URL | Produktbilleder, miniaturer, branding, marketingmateriale |

Offentlige filer caches på Whops CDN og kan ikke tilbagekaldes, så behold standardværdien `private` til alt følsomt. Se [Upload filer](https://docs.whop.com/da/developer/guides/upload-files.md#accessing-private-files) for mere.

## Brug af en uploadet fil

Når en fil er `ready`, kan du angive dens `id` overalt, hvor Whop accepterer et dokument — for eksempel beviser i en [tvist](https://docs.whop.com/da/api-reference/disputes/dispute) eller en kontos juridiske dokumenter.

## Næste trin

> [card] [Upload filer (SDK)](https://docs.whop.com/da/developer/guides/upload-files.md)
>
> Hvordan SDK'ets metoder `files.create` og `files.retrieve` pakker dette forløb ind.

> [card] [Create File](https://docs.whop.com/da/api-reference/files/create-file.md)
>
> Komplet reference for forespørgsel og svar til create-endpointet.

> [card] [Complete File Multipart Upload](https://docs.whop.com/da/api-reference/files/complete-file-multipart-upload.md)
>
> Reference til samling af multipart-dele.

> [card] [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
>
> Hvorfor `Api-Version-Date`-headeren er vigtig, og hvordan du fastlåser den.


## Related topics

- [Upload filer](https://docs.whop.com/da/developer/guides/upload-files.md)
- [Files-API](https://docs.whop.com/da/api-reference/files/file.md)
- [Håndtér verificerings-RFI'er](https://docs.whop.com/da/developer/verification/rfis.md)
