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

# Archivo

> Un archivo que se ha subido o cuya subida está pendiente.

```json Example theme={null}
{
	"content_type": "image/jpeg",
	"filename": "document.pdf",
	"id": "file_xxxxxxxxxxxxx",
	"size": "123.45",
	"upload_status": "pending",
	"url": "<string>",
	"visibility": "public"
}
```

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

El tipo MIME del archivo subido (p. ej., image/jpeg, video/mp4, audio/mpeg).

Ejemplo: `image/jpeg`

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

El nombre de archivo original del archivo subido, incluida su extensión.

Ejemplo: `document.pdf`

**id** `string` *required*

El identificador único del archivo.

Ejemplo: `file_xxxxxxxxxxxxx`

**size** `string | null` *required*

El tamaño del archivo en bytes. Null si el archivo no ha terminado de subirse.

Ejemplo: `123.45`

**upload\_status** `UploadStatuses` *required*

El estado actual de la subida del archivo (p. ej., pending, ready).

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

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

La URL para acceder al archivo. Para archivos públicos, es una URL de CDN permanente. Para archivos privados, es una URL firmada que caduca. Null si el archivo no ha terminado de subirse.

**visibility** `FileVisibility` *required*

Indica si el archivo es accesible públicamente o requiere autenticación.

Opciones disponibles: `public`, `private`


## Related topics

- [Subir archivos](https://docs.whop.com/es/developer/guides/upload-files.md)
- [API de archivos](https://docs.whop.com/es/api-reference/files/file.md)
- [Subir archivos directamente](https://docs.whop.com/es/developer/guides/direct-file-uploads.md)
