Skip to main content
POST
TypeScript

Autorizaciones

Authorization
string
header
requerido

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.

Encabezados

Idempotency-Key
string

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

Maximum string length: 255
Ejemplo:

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

Api-Version-Date
string

Pins the request to a dated API version.

Ejemplo:

"2026-11-17"

Parámetros de ruta

id
string
requerido

The unique identifier of the file, prefixed file_.

Cuerpo

application/json
multipart_parts
object[]
requerido

Every uploaded part, in order.

multipart_upload_id
string
requerido

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

Ejemplo:

"upload-id"

Respuesta

multipart upload completed

blurhash
string | null
requerido

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

Ejemplo:

null

content_type
string | null
requerido

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

Ejemplo:

"application/pdf"

created_at
string
requerido

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

Ejemplo:

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

duration_seconds
number | null
requerido

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

Ejemplo:

null

filename
string | null
requerido

The original filename, including its extension.

Ejemplo:

"evidence.pdf"

height
integer | null
requerido

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

Ejemplo:

null

id
string
requerido

The file's ID, prefixed file_.

Ejemplo:

"file_xxxxxxxxxxxxxx"

object
string
requerido

The type of this object, always file.

Ejemplo:

"file"

removed_by_moderation
boolean
requerido

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

Ejemplo:

false

size
integer | null
requerido

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

Ejemplo:

9670

upload_status
enum<string>
requerido

Where the file is in its upload lifecycle.

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

"pending"

url
string | null
requerido

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.

Ejemplo:

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

visibility
enum<string>
requerido

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

Opciones disponibles:
public,
private
Ejemplo:

"private"

waveform_url
string | null
requerido

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

Ejemplo:

null

width
integer | null
requerido

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

Ejemplo:

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.

Ejemplo:

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.

Ejemplo:

"upload-id"

multipart_upload_urls
object[] | null
upload_headers
object

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

Ejemplo:
upload_url
string | null

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

Ejemplo:

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