Skip to main content
POST
Get a file upload URL

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Path Parameters

productID
string<uuid>
required

Product ID.

Body

application/json
fileName
string
required

File name, as the buyer will see it.

contentType
string
required

The file's MIME type (for example, application/pdf). Use the same one on the upload PUT.

sizeBytes
integer<int64>
required

File size in bytes.

Response

Upload URL and objectKey.

uploadUrl
string

Signed URL to send the bytes with PUT, without your key. Valid for this file only.

objectKey
string

Identifier of the uploaded file. Pass it to PUT /products/{productID}/deliverable.

expiresAt
string<date-time>

When the uploadUrl expires (15 minutes).