Skip to main content
POST
TypeScript

Yetkilendirmeler

Authorization
string
header
gerekli

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Başlıklar

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Örnek:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Örnek:

"2026-11-17"

Yol Parametreleri

id
string
gerekli

The unique identifier of the file, prefixed file_.

Gövde

application/json
multipart_parts
object[]
gerekli

Every uploaded part, in order.

multipart_upload_id
string
gerekli

The ID of the multipart upload, returned by Create File.

Örnek:

"upload-id"

Yanıt

multipart upload completed

blurhash
string | null
gerekli

BlurHash placeholder for an image or video. Null when unavailable or removed by moderation.

Örnek:

null

content_type
string | null
gerekli

The original file's MIME type, for example application/pdf. It is kept when moderation removes the file.

Örnek:

"application/pdf"

created_at
string
gerekli

When the file was created, as an ISO 8601 timestamp.

Örnek:

"2026-01-01T12:00:00.000Z"

duration_seconds
number | null
gerekli

Audio or video duration in seconds. Null when unavailable or removed by moderation.

Örnek:

null

filename
string | null
gerekli

The original filename, including its extension.

Örnek:

"evidence.pdf"

height
integer | null
gerekli

Image or video height in pixels. Null when unavailable or removed by moderation.

Örnek:

null

id
string
gerekli

The file's ID, prefixed file_.

Örnek:

"file_xxxxxxxxxxxxxx"

object
string
gerekli

The type of this object, always file.

Örnek:

"file"

removed_by_moderation
boolean
gerekli

Whether moderation removed the file. When true, url serves a replacement image. filename, size and content_type still describe the original file.

Örnek:

false

size
integer | null
gerekli

The file size in bytes. null until the upload has finished.

Örnek:

9670

upload_status
enum<string>
gerekli

Where the file is in its upload lifecycle.

Mevcut seçenekler:
pending,
processing,
ready,
failed
Örnek:

"pending"

url
string | null
gerekli

A URL to download the file. Public files get a permanent CDN URL, and private files get a signed URL that expires. null until the upload has finished. When moderation removes the file, a replacement image URL.

Örnek:

"https://whop-assets-example.s3.amazonaws.com/uploads/audio/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

visibility
enum<string>
gerekli

public files are served from an unsigned CDN URL. private files are served from a signed URL that expires.

Mevcut seçenekler:
public,
private
Örnek:

"private"

waveform_url
string | null
gerekli

Audio waveform URL. Null when unavailable or removed by moderation.

Örnek:

null

width
integer | null
gerekli

Image or video width in pixels. Null when unavailable or removed by moderation.

Örnek:

null

multipart_chunk_size
integer | null

The byte size each part (except the last) must be. Present only on create, and only for multipart uploads.

Örnek:

5242880

multipart_upload_id
string | null

The ID of the multipart upload, passed back to complete. Present only on create, and only for multipart uploads.

Örnek:

"upload-id"

multipart_upload_urls
object[] | null
upload_headers
object

Headers to send with the upload PUT. Present only on create.

Örnek:
upload_url
string | null

Presigned URL to PUT the file's bytes to. Present only on create, and only for single-part uploads.

Örnek:

"https://whop-assets-example.s3.amazonaws.com/uploads/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/application.pdf"