Skip to main content
POST
Upload a header sample

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Body

multipart/form-data
file
file
required

JPEG, PNG, MP4 or PDF up to 16 MB. A GIF is an MP4 of up to 3.5 MB.

format
enum<string>
Available options:
IMAGE,
VIDEO,
GIF,
DOCUMENT

Response

The upload handle.

handle
string