Skip to main content
POST
Get an upload link

Authorizations

Authorization
string
header
required

An API key from Settings, API & MCP: pm_live_...

Headers

Idempotency-Key
string

Makes a retry safe: the same key within 24 hours answers with the first request's result. Up to 255 printable characters.

Required string length: 1 - 255

Body

application/json

Asks for a link to upload one file to.

mime_type
enum<string>
required
Available options:
image/jpeg,
image/png,
image/webp,
image/gif,
image/avif,
video/mp4,
video/mpeg,
video/webm,
video/quicktime
size_bytes
integer
required

The file's exact size. One link takes up to 1 GB.

Required range: 1 <= x <= 9007199254740991
name
string
Required string length: 1 - 255

Response

Upload the file here.

upload
object
required

Where to upload a file. Then send its path to POST /media.