Skip to main content
PATCH
/
publisher
/
{publisher_id}
/
media-library
/
{id}
Update Media
curl --request PATCH \
  --url https://cms.thepublive.com/publisher/{publisher_id}/media-library/{id}/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>",
  "alt_text": "<string>",
  "caption": "<string>",
  "source": "<string>",
  "meta_data": {}
}
'
{
  "status": "success",
  "message": "Updated Successfully",
  "data": {
    "id": 999,
    "filename": "budget-2026.jpg",
    "alt_text": "Updated alt text",
    "caption": "Budget session in Parliament",
    "path": "https://cdn.publive.com/images/budget-2026.jpg",
    "source": "Reuters",
    "type": "Image",
    "meta_data": {"width": 1200, "height": 630}
  }
}
Updates metadata of an existing media asset. Only send the fields you want to change.
The following fields are immutable after creation and cannot be changed via update:
  • path — Media URL / CDN path
  • type — Media type (Image, Video, File)

​
Updatable fields

​
publisher_id
string
required
Your Publisher ID
​
id
integer
required
Media ID
​
filename
string
Filename
​
alt_text
string
Alt text
​
caption
string
Caption
​
source
string
Source/credit
​
meta_data
object
Metadata

​
Example request

curl -X PATCH \
  'https://cms.thepublive.com/publisher/123/media-library/999/' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"source": "Reuters", "alt_text": "Updated alt text"}'

{
  "status": "success",
  "message": "Updated Successfully",
  "data": {
    "id": 999,
    "filename": "budget-2026.jpg",
    "alt_text": "Updated alt text",
    "caption": "Budget session in Parliament",
    "path": "https://cdn.publive.com/images/budget-2026.jpg",
    "source": "Reuters",
    "type": "Image",
    "meta_data": {"width": 1200, "height": 630}
  }
}