Skip to main content
PATCH https://cms.thepublive.com/publisher/{publisher_id}/post/{id}/ Updates an existing post. Only send the fields you want to change (partial update).

​
Path Parameters

NameTypeDescription
idintegerPost ID

​
Headers

NameTypeRequiredDescription
usernamestringYesAPI Key
passwordstringYesAPI Secret
Content-TypestringYesapplication/json

​
Request Body

Send only the fields you wish to update. Common fields:
FieldTypeDescription
titlestringPost headline
contentstringHTML body content
statusstringDraft, Published, Scheduled, Approval Pending
primary_categoryintegerCategory ID
contributorsstringComma-separated author IDs
tagsstringComma-separated tag IDs
categoriesstringComma-separated category IDs
banner_urlintegerMedia ID for featured image
short_descriptionstringSEO meta description
hide_banner_imagebooleanHide the featured image
typestringPost type

​
Example Request

curl -X PATCH \
  'https://cms.thepublive.com/publisher/123/post/50123/' \
  -H 'username: YOUR_API_KEY' \
  -H 'password: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"status": "Published", "title": "Updated Title"}'

{
  "status": "success",
  "message": "Updated Successfully",
  "data": {
    "id": 50123,
    "title": "Updated Title",
    "slug": "union-budget-2026-highlights",
    "type": "Article",
    "status": "Published",
    "primary_category": {
      "id": 100,
      "name": "Business"
    },
    "updated_at": "2026-02-12T15:00:00Z"
  }
}