Skip to main content
PATCH
/
publisher
/
{publisher_id}
/
post
/
{id}
Update Post
curl --request PATCH \
  --url https://cms.thepublive.com/publisher/{publisher_id}/post/{id}/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "content": "<string>",
  "status": "<string>",
  "custom_published_at": "<string>",
  "primary_category": 123,
  "contributors": "<string>",
  "tags": "<string>",
  "categories": "<string>",
  "banner_url": 123,
  "short_description": "<string>",
  "hide_banner_image": true
}
'
{
  "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"
  }
}
Updates an existing post. Only send the fields you want to change (partial update). Note that identifiers and core types cannot be modified after creation. Send only the fields you wish to update. Common fields:
​
publisher_id
string
required
Your Publisher ID
​
id
integer
required
Post ID
​
title
string
Post headline
​
content
string
HTML body content. Supports structured blocks such as FAQ sections.
​
status
string
Draft, Published, Scheduled, Approval Pending
​
custom_published_at
string
ISO 8601 timestamp for backdated publishing (e.g., 2025-12-15T10:00:00Z). See the Migration Guides for details.
​
primary_category
integer
Category ID
​
contributors
string
Comma-separated author IDs
​
tags
string
Comma-separated tag IDs
​
categories
string
Comma-separated category IDs
​
banner_url
integer
Media ID for featured image
​
short_description
string
SEO meta description
​
hide_banner_image
boolean
Hide the featured image

​
Example request

curl -X PATCH \
  'https://cms.thepublive.com/publisher/123/post/50123/' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>' \
  -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"
  }
}
Last modified on April 21, 2026