Skip to main content
POST
Register Media (URL)
Registers an already-hosted media URL as a new entry in the library, without uploading a file. Send the request as application/x-www-form-urlencoded with a path field pointing at the external URL.
filename must include a file extension, and it must match the file path points at — e.g. hero-image.jpg.
To upload a file directly instead, see Upload Media (File). 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

application/x-www-form-urlencoded
filename
string
required

Must include a file extension matching the file path points at.

Example:

"hero-image.jpg"

path
string
required

Immutable after creation. External media URL.

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