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

# API Fichiers

> Un fichier est un document ou un objet multimédia téléversé, identifié par un ID `file_`.

La création d'un fichier renvoie une destination présignée ; téléversez-y les octets et le fichier passe à l'état `ready`.

Utilisez l'API Fichiers pour créer un fichier, téléverser son contenu directement vers le stockage (en un seul PUT, ou en plusieurs parties pour les fichiers volumineux), et le récupérer en interrogeant régulièrement son état de disponibilité. L'ID d'un fichier prêt peut être joint partout où Whop accepte des fichiers.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les fichiers](https://docs.whop.com/fr/api-reference/files/list-files.md) | GET `/files` |
| [Récupérer un fichier](https://docs.whop.com/fr/api-reference/files/retrieve-file.md) | GET `/files/{id}` |
| [Créer un fichier](https://docs.whop.com/fr/api-reference/files/create-file.md) | POST `/files` |
| [Finaliser le téléversement multipartie d'un fichier](https://docs.whop.com/fr/api-reference/files/complete-file-multipart-upload.md) | POST `/files/{id}/complete` |

## Attributs

**id** `string` *required*

L'ID du fichier, préfixé par `file_`.

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

Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu'il n'est pas
disponible ou qu'il a été supprimé par la modération.

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

Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est
conservé lorsque la modération supprime le fichier.

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

Date de création du fichier, sous forme d'horodatage ISO 8601.

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

Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle n'est pas
disponible ou qu'elle a été supprimée par la modération.

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

Le nom de fichier d'origine, extension comprise.

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

Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas
disponible ou qu'elle a été supprimée par la modération.

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

La taille en octets que doit avoir chaque partie (sauf la dernière). Présent
uniquement à la création, et uniquement pour les téléversements multiparties.

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

L'ID du téléversement multipartie, à renvoyer à `complete`. Présent uniquement
à la création, et uniquement pour les téléversements multiparties.

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

L'URL présignée de chaque partie. Présent uniquement à la création, et uniquement pour les téléversements multiparties.

> [accordion] Propriétés
>
> **part\_number** `integer` *required*
>
> L'index (commençant à 1) de cette partie dans le téléversement multipartie.
>
> **url** `string` *required*
>
> L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.

**object** `string` *required*

Le type de cet objet, toujours `file`.

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

Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une
image de remplacement. `filename`, `size` et `content_type` décrivent toujours
le fichier d'origine.

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

La taille du fichier en octets. `null` tant que le téléversement n'est pas terminé.

**upload\_headers** `object`

En-têtes à envoyer avec le PUT de téléversement. Présent uniquement à la création.

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

L'étape du cycle de téléversement à laquelle se trouve le fichier.

Options disponibles : `pending`, `processing`, `ready`, `failed`

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

URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent
uniquement à la création, et uniquement pour les téléversements en une seule partie.

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

Une URL pour télécharger le fichier. Les fichiers publics reçoivent une URL CDN
permanente, et les fichiers privés une URL signée qui expire. `null` tant que
le téléversement n'est pas terminé. Lorsque la modération supprime le fichier,
une URL d'image de remplacement.

**visibility** `string` *required*

Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.

Options disponibles : `public`, `private`

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

URL de la forme d'onde audio. Null lorsqu'elle n'est pas disponible ou qu'elle
a été supprimée par la modération.

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

Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas
disponible ou qu'elle a été supprimée par la modération.

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

- [Fichier](https://docs.whop.com/fr/api-reference/legacy/files/file.md)
- [API Media](https://docs.whop.com/fr/api-reference/media/media.md)
- [API Accounts](https://docs.whop.com/fr/api-reference/accounts/account.md)
