Skip to main content
Posts are the primary content entity in Publive. They support multiple content types and publishing workflows.

Post Object

FieldTypeEditableRequiredDescription
idintegerNoUnique post identifier
titlestringYesYesPost headline
english_titlestringNoYesEnglish headline (for slug generation)
slugstringNoURL-friendly identifier (auto-generated)
typestringNoYesArticle, Video, Web Story, Gallery, LiveBlog, CustomPage, BlankPage
statusstringYesYesDraft, Published, Scheduled, Approval Pending
primary_categoryintegerNoYesCategory ID (mandatory for publishing)
contributorsstringYesYesComma-separated author IDs (e.g., "12,15,27")
contentstring (HTML)YesNoPost body content
tagsstringYesNoComma-separated tag IDs
categoriesstringYesNoComma-separated additional category IDs
banner_urlintegerYesNoFeatured image media ID
banner_descriptionstringYesNoFeatured image caption
short_descriptionstringYesNoSEO meta description
summarystringYesNoSummary displayed below title
seo_keyphrasestringYesNoFocus keyword for SEO
meta_dataobjectYesNoKey-value pairs (access_type, video URLs, etc.)
custom_published_atdatetimeYesNoBackdated publish date
scheduled_atdatetimeYesNoFuture publish date (requires Scheduled status)
hide_banner_imagebooleanYesNoHide the featured image
word_countintegerNoAuto-calculated word count
seo_scoreintegerNoSEO score
sourcestringNoContent origin (e.g., HeadlessCMS)

Endpoints

MethodEndpointDescription
GET/post/List all posts
POST/post/Create a new post
GET/post/{id}/Retrieve a post
PATCH/post/{id}/Update a post
DELETE/post/{id}/Delete a post