https://demo.notifuse.com/api/blogPosts.update Replaces a post's metadata. This is not a patch: optional fields left out are cleared, so send the post back with your changes applied.
To change the body, update the template with templates.update, which saves a new template version. A post pinned to a template_version keeps rendering the old one until you update the post with the new version; a post at version 0 follows the latest version on its own, within the 5-minute page cache.
Requires the blog write permission.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Query Parameters
The ID of the workspace. Passed in the query string, not the body.
- Example: ws_1234567890
Body application/json
An existing category.
- Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
Lowercase letters, digits and single hyphens. Must be unique across the whole workspace, not just within the category.
- Maximum length: 100
- Example: october-release
- Maximum length: 500
- Example: What shipped in October
A web template (channel: web) holding the post body — create it first with templates.create. Its existence is not checked here: a post pointing at a missing template is saved and renders with an empty body.
- Example: blog_october_release
The template version to render. Omit it (or send 0) to always render the template's latest version; pin a version to control exactly when a template edit reaches readers.
- Default: 0
- Example: 1
- Example: A faster editor, scheduled broadcasts and a new API.
- Example: https://cdn.example.com/blog/october.png
Show child attributes
- Example: Jane Doe
- Example: https://cdn.example.com/avatars/jane.png
- Example: 4
Search and social metadata for the page, exposed to the blog theme.
Show child attributes
- Example: Release notes for October
- Example: Everything that shipped this month.
Open Graph title
Open Graph description
Open Graph image URL
- Example: https://cdn.example.com/og/october.png
- Example: https://blog.example.com/product/october-release
Content of the robots meta tag.
- Example: index,follow
- Example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427
Response
200 Post updated object
Show child attributes
Server-generated UUID.
- Example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427
- Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
The post's path segment on the blog (/{category_slug}/{post_slug}).
- Example: october-release
Show child attributes
The post's H1.
- Example: What shipped in October
The web template holding the post body.
Show child attributes
- Example: blog_october_release
The template version the post renders. 0 means the latest version, whatever it is at render time.
- Example: 3
- Example: A faster editor, scheduled broadcasts and a new API.
- Example: https://cdn.example.com/blog/october.png
Show child attributes
- Example: Jane Doe
- Example: https://cdn.example.com/avatars/jane.png
Displayed as given; not computed from the body.
- Example: 4
Search and social metadata for the page, exposed to the blog theme.
Show child attributes
- Example: Release notes for October
- Example: Everything that shipped this month.
Open Graph title
Open Graph description
Open Graph image URL
- Example: https://cdn.example.com/og/october.png
- Example: https://blog.example.com/product/october-release
Content of the robots meta tag.
- Example: index,follow
Absent while the post is a draft.
- Example: 2026-10-01T09:00:00Z
400 Bad request - validation failed, slug taken, or post or category not found object
Error message
401 Unauthorized - invalid or missing authentication token object
Error message
403 Forbidden - missing the blog write permission object
Error message
The permission resource the endpoint requires.
- Example: blog
The access level the endpoint requires on that resource.
- Available options: read, write