Skip to main content
GET
List blog posts

Authorizations

Authorization
string
header
required

API token for authentication

Query Parameters

workspace_id
string
required

The ID of the workspace

category_id
string

Only posts in this category.

status
enum<string>
default:all

draft is posts never published or since unpublished; published is every post with a publication date, including one dated in the future.

Available options:
all,
draft,
published
page
integer
default:1

1-indexed page number.

Required range: x >= 1
limit
integer
default:50

Posts per page. Values above the maximum are clamped to it rather than refused.

Required range: x <= 100

Response

One page of posts

posts
object[] | null
required

The requested page. null rather than [] when the page is empty.

total_count
integer
required

Posts matching the filters across all pages.

Example:

128