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

> File, `file_` kimliğiyle tanımlanan, yüklenmiş bir belge veya medya nesnesidir.

Bir dosya oluşturmak önceden imzalanmış bir hedef döndürür; baytları oraya yükleyin, dosya `ready` olur.

Files API'yi bir dosya oluşturmak, içeriğini doğrudan depolamaya yüklemek (tek bir PUT ile veya büyük dosyalar için parçalar halinde) ve hazır olup olmadığını yoklarken dosyayı almak için kullanın. Hazır bir dosyanın kimliği, Whop'un dosya kabul ettiği her yere eklenebilir.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Dosyaları Listele](https://docs.whop.com/tr/api-reference/files/list-files.md) | GET `/files` |
| [Dosyayı Getir](https://docs.whop.com/tr/api-reference/files/retrieve-file.md) | GET `/files/{id}` |
| [Dosya Oluştur](https://docs.whop.com/tr/api-reference/files/create-file.md) | POST `/files` |
| [Dosya Çok Parçalı Yüklemesini Tamamla](https://docs.whop.com/tr/api-reference/files/complete-file-multipart-upload.md) | POST `/files/{id}/complete` |

## Öznitelikler

**id** `string` *required*

`file_` önekli dosya kimliği.

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

Bir görsel veya video için BlurHash yer tutucusu. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.

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

Orijinal dosyanın MIME türü, örneğin `application/pdf`. Moderasyon dosyayı kaldırdığında korunur.

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

Dosyanın ISO 8601 zaman damgası olarak oluşturulma zamanı.

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

Saniye cinsinden ses veya video süresi. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.

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

Uzantısı dahil orijinal dosya adı.

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

Piksel cinsinden görsel veya video yüksekliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.

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

Her parçanın (sonuncusu hariç) olması gereken bayt boyutu. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.

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

`complete` işlemine geri iletilen çok parçalı yüklemenin kimliği. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.

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

Her parça için önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.

> [accordion] Özellikler
>
> **part\_number** `integer` *required*
>
> Bu parçanın çok parçalı yükleme içindeki 1 tabanlı dizini.
>
> **url** `string` *required*
>
> Bu parçanın baytlarının PUT ile gönderileceği önceden imzalanmış URL.

**object** `string` *required*

Bu nesnenin türü, her zaman `file`.

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

Moderasyonun dosyayı kaldırıp kaldırmadığı. `true` olduğunda `url` yerine geçen bir görsel sunar. `filename`, `size` ve `content_type` yine orijinal dosyayı tanımlar.

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

Bayt cinsinden dosya boyutu. Yükleme bitene kadar `null`.

**upload\_headers** `object`

Yükleme PUT isteğiyle gönderilecek başlıklar. Yalnızca oluşturma sırasında bulunur.

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

Dosyanın yükleme yaşam döngüsünde nerede olduğu.

Kullanılabilir seçenekler: `pending`, `processing`, `ready`, `failed`

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

Dosyanın baytlarının PUT ile gönderileceği önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca tek parçalı yüklemeler için bulunur.

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

Dosyayı indirmek için bir URL. Herkese açık dosyalar kalıcı bir CDN URL'si, özel dosyalar ise süresi dolan imzalı bir URL alır. Yükleme bitene kadar `null`. Moderasyon dosyayı kaldırdığında, yerine geçen bir görsel URL'si.

**visibility** `string` *required*

`public` dosyalar imzasız bir CDN URL'sinden sunulur. `private` dosyalar süresi dolan imzalı bir URL'den sunulur.

Kullanılabilir seçenekler: `public`, `private`

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

Ses dalga formu URL'si. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.

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

Piksel cinsinden görsel veya video genişliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.

```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 sürümleri](https://docs.whop.com/tr/developer/api/versioning.md)
- [Chat API](https://docs.whop.com/tr/developer/guides/chat.md)
- [Update Account](https://docs.whop.com/tr/api-reference/accounts/update-account.md)
