Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

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.

헤더

Idempotency-Key
string

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

Maximum string length: 255
예시:

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

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

The unique identifier of the file, prefixed file_.

본문

application/json
multipart_parts
object[]
필수

Every uploaded part, in order.

multipart_upload_id
string
필수

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

예시:

"upload-id"

응답

multipart upload completed

blurhash
string | null
필수

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

예시:

null

content_type
string | null
필수

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

예시:

"application/pdf"

created_at
string
필수

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

예시:

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

duration_seconds
number | null
필수

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

예시:

null

filename
string | null
필수

The original filename, including its extension.

예시:

"evidence.pdf"

height
integer | null
필수

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

예시:

null

id
string
필수

The file's ID, prefixed file_.

예시:

"file_xxxxxxxxxxxxxx"

object
string
필수

The type of this object, always file.

예시:

"file"

removed_by_moderation
boolean
필수

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

예시:

false

size
integer | null
필수

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

예시:

9670

upload_status
enum<string>
필수

Where the file is in its upload lifecycle.

사용 가능한 옵션:
pending,
processing,
ready,
failed
예시:

"pending"

url
string | null
필수

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.

예시:

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

visibility
enum<string>
필수

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

사용 가능한 옵션:
public,
private
예시:

"private"

waveform_url
string | null
필수

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

예시:

null

width
integer | null
필수

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

예시:

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.

예시:

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.

예시:

"upload-id"

multipart_upload_urls
object[] | null
upload_headers
object

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

예시:
upload_url
string | null

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

예시:

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