Skip to main content
POST
Start a direct upload

Authorizations

Authorization
string
header
required

A secret key from Print.App admin → Domains → Secret keys, sent as Authorization: Bearer sk_…. Server-side only.

Headers

Idempotency-Key
string

Makes a retry safe: a second request with the same key and the same body gets the first response back (for 24 hours) instead of creating the resource again. Use a new key, such as a UUID, for every new request.

Required string length: 1 - 255

Body

application/json

The file you are about to upload.

filename
string
required

The file's name, with its extension.

Required string length: 1 - 200
contentType
enum<string>
required

The file's media type.

Available options:
image/png,
image/jpeg,
image/webp,
image/gif,
image/svg+xml,
image/tiff,
application/pdf
size
integer

The file size in bytes, up to 200 MB. The upload is refused if the file is larger.

Required range: 1 <= x <= 209715200
title
string

A name for the file. Default: the file name.

Required string length: 1 - 200

Response

Created.

A presigned form for one direct upload.

object
string
required
Allowed value: "file_upload"
fileId
string
required

The id the file will have once uploaded.

upload
object
required
maxBytes
integer
required
expiresAt
string<date-time> | null
required