https://demo.notifuse.com/api/blogPosts.list Returns posts page by page, drafts included unless filtered out. Posts come by the date they are known by, newest first: their publication date (a scheduled post's date to come included), or for a draft its last edit; with status=draft, most recently edited first; with status=published, most recently published first; with status=scheduled, soonest to publish first. Page through with page and limit until you have total_count posts. Requires the blog read permission.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Query Parameters
The ID of the workspace
- Example: ws_1234567890
Only posts in this category.
- Example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
draft is posts never published or since unpublished; published is every post with a publication date, including one dated in the future; scheduled is only posts whose publication date is still to come.
- Default: all
- Available options: all, draft, published, scheduled
- Example: published
Only posts whose title contains this text, case-insensitively. Leading and trailing spaces are ignored; total_count counts the matching posts.
- Maximum length: 200
- Example: release notes
1-indexed page number.
- Default: 1
- Required range: x >= 1
- Example: 2
Posts per page. Values above the maximum are clamped to it rather than refused.
- Default: 50
- Required range: x <= 100
- Example: 50
Response
200 One page of posts object
The requested page. null rather than [] when the page is empty.
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
Posts matching the filters across all pages.
- Example: 128
400 Bad request - invalid query parameters object
Error message
401 Unauthorized - invalid or missing authentication token object
Error message
403 Forbidden - missing the blog read 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
500 Internal server error object
Error message