Skip to main content
POST
Upload Media (File)
Uploads a file directly to the media library as multipart/form-data.
filename must include a file extension, and it must match the file you send in media — e.g. hero-image.jpg for a JPEG.
To register an existing external URL instead of uploading a file, see Register Media (URL). Both pages document the same endpoint — pick whichever example below matches how you’re sending the request.

Example Request

Authorizations

Authorization
string
header
required

HTTP Basic Auth using your Publive API key pair, base64-encoded.

Path Parameters

publisher_id
string
required

Your Publisher ID

Body

multipart/form-data
filename
string
required

Must include a file extension matching the file sent in media.

Example:

"hero-image.jpg"

media
file
required

Immutable after creation. The file to upload.

alt_text
string
caption
string
source
string
type
enum<string>

Immutable after creation.

Available options:
Image,
Video,
File
meta_data
object

Response

Created

Last modified on August 12, 2026