Blog

Publish a blog post

POST https://demo.notifuse.com/api/blogPosts.publish

Publishes a draft: it appears on the blog's home and category pages, at its own URL, and in the RSS and JSON feeds. Publishing a post that is already published is refused; unpublish it first to change its date. Requires the blog write permission.

Authorizations

Authorization string header required

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Query Parameters

workspace_id string required

The ID of the workspace. Passed in the query string, not the body.

Example ws_1234567890

Body application/json

id string required
Example 1b4e28ba-2fa1-11d2-883f-0016d3cca427
published_at string<date-time>

The publication date to record, defaulting to now. Use it to backdate posts you import. A future date does not schedule the post: it goes live on the blog immediately, and only its appearance in the RSS and JSON feeds waits for the date.

Example 2024-03-12T08:00:00Z

Response

200 Post published object
success boolean
Example true
400 Bad request - missing id, post not found or already published object
error string required

Error message

401 Unauthorized - invalid or missing authentication token object
error string required

Error message

403 Forbidden - missing the blog write permission object
error string required

Error message

resource string required

The permission resource the endpoint requires.

Example blog
permission string required

The access level the endpoint requires on that resource.

Options read, write