Skip to main content
POST
Add a file

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

Adds a file to your media library: one you uploaded (path), or one PostMesh downloads (url).

path
string
required

The path POST /media/uploads gave, once the file is uploaded.

Required string length: 1 - 512
name
string
Required string length: 1 - 255

Response

Added.

media
object
required

A file in your media library.