Media Library - Publive Docs

The Media Library stores all media assets used across your content. Media items are referenced by ID in post fields like banner_url.

Media Object

Field	Type	Editable	Required	Description
`id`	integer	No	—	Unique media identifier
`filename`	string	Yes	Yes	Filename with extension, matching the uploaded or linked file
`alt_text`	string	Yes	No	Alt text for images
`caption`	string	Yes	No	Media caption
`path`	string (URL)	No	Yes	Media object URL
`source`	string	Yes	No	Source/credit for the media
`type`	string	No	—	`Image`, `Video`, or `File` (default: `Image`)
`meta_data`	object	Yes	No	Metadata (width, height, etc.)
`date`	string	No	—	Date added to library
`member`	string	No	—	Member who uploaded the media

Endpoints

Method	Endpoint	Description
GET	`/media-library/`	List all media
POST	`/media-library/`	Register an existing media URL
POST	`/media-library/`	Upload a media file
GET	`/media-library/{id}/`	Retrieve media
PATCH	`/media-library/{id}/`	Update media metadata
DELETE	`/media-library/{id}/`	Delete media

Last modified on August 12, 2026