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

# Files API

> Een File is een geüpload document of mediaobject, geïdentificeerd door een `file_`-ID.

Het aanmaken van een bestand retourneert een vooraf ondertekende bestemming; upload de bytes daarheen en het bestand wordt `ready`.

Gebruik de Files API om een bestand aan te maken, de inhoud ervan rechtstreeks naar de opslag te uploaden (in één PUT, of in delen voor grote bestanden), en het op te halen terwijl je pollt of het gereed is. De ID van een gereed bestand kan worden toegevoegd overal waar Whop bestanden accepteert.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Bestanden weergeven](https://docs.whop.com/nl/api-reference/files/list-files.md) | GET `/files` |
| [Bestand ophalen](https://docs.whop.com/nl/api-reference/files/retrieve-file.md) | GET `/files/{id}` |
| [Bestand aanmaken](https://docs.whop.com/nl/api-reference/files/create-file.md) | POST `/files` |
| [Multipart-upload van bestand voltooien](https://docs.whop.com/nl/api-reference/files/complete-file-multipart-upload.md) | POST `/files/{id}/complete` |

## Attributen

**id** `string` *required*

De ID van het bestand, met voorvoegsel `file_`.

**blurhash** `string | null` *required*

BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.

**content\_type** `string | null` *required*

Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.

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

Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.

**duration\_seconds** `number | null` *required*

Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.

**filename** `string | null` *required*

De oorspronkelijke bestandsnaam, inclusief extensie.

**height** `integer | null` *required*

Hoogte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**multipart\_chunk\_size** `integer | null`

De bytegrootte die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.

**multipart\_upload\_id** `string | null`

De ID van de multipart-upload, terug te geven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.

**multipart\_upload\_urls** `object[] | null`

De vooraf ondertekende URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.

> [accordion] Eigenschappen
>
> **part\_number** `integer` *required*
>
> De op 1 gebaseerde index van dit deel binnen de multipart-upload.
>
> **url** `string` *required*
>
> De vooraf ondertekende URL waarnaar de bytes van dit deel met PUT worden verstuurd.

**object** `string` *required*

Het type van dit object, altijd `file`.

**removed\_by\_moderation** `boolean` *required*

Of moderatie het bestand heeft verwijderd. Bij `true` levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.

**size** `integer | null` *required*

De bestandsgrootte in bytes. `null` totdat de upload is voltooid.

**upload\_headers** `object`

Headers om mee te sturen met de upload-PUT. Alleen aanwezig bij aanmaken.

**upload\_status** `string` *required*

Waar het bestand zich in de uploadlevenscyclus bevindt.

Beschikbare opties: `pending`, `processing`, `ready`, `failed`

**upload\_url** `string | null`

Vooraf ondertekende URL waarnaar de bytes van het bestand met PUT worden verstuurd. Alleen aanwezig bij aanmaken, en alleen voor uploads in één deel.

**url** `string | null` *required*

Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL, en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.

**visibility** `string` *required*

`public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.

Beschikbare opties: `public`, `private`

**waveform\_url** `string | null` *required*

URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.

**width** `integer | null` *required*

Breedte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

```json File theme={null}
{
	"id": "file_xxxxxxxxxxxxxx",
	"object": "file",
	"filename": "evidence.pdf",
	"content_type": "application/pdf",
	"size": 9670,
	"width": null,
	"height": null,
	"blurhash": null,
	"duration_seconds": null,
	"waveform_url": null,
	"visibility": "private",
	"upload_status": "ready",
	"url": "https://whop-assets-example.s3.amazonaws.com/uploads/2026-09-15/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/evidence.pdf",
	"created_at": "2026-09-15T14:30:00.000Z",
	"removed_by_moderation": false
}
```


## Related topics

- [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
- [Chat API](https://docs.whop.com/nl/developer/guides/chat.md)
- [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md)
