Publish, schedule or unpublish a blog post

POST /content/api/v2/blog-posts/:blog_post_id/publish-action

Method Details

HTTP Methods:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Either schedules or cancels publishing based on the POSTed JSON. Publish action accepts a JSON object in this form: {"action": ..the action..} Allowable actions are:

  • "push-buffer-live": copies the current contents of the auto-save buffer into the live blog post.
  • "schedule-publish": sets up the content for publishing at the publish_date already set on the post.
  • "cancel-publish": cancels a previously scheduled blog post publish.

Note that this endpoint must always be used to publish a blog post. Use the Create or Update endpoints to set the publish_date, but then use this endpoint to trigger the actual publish event.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
blog_post_id Used in the request URL Unique identifier for a particular blog