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.

  • Available options: read, write