Content

Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

Page number, from 1 to 10,000

Range

1 – 10000

Example

1

Items per page (max 100)

Range

1 – 100

Example

20

Filter by post category

Max length

60

Example

guides

A published post. Both endpoints serve the stored row; body is markdown.

Opaque post id. A string, not a number: posts are keyed like every other authored record here.

URL-safe slug, and what /v1/blog/{slug} addresses.

Post headline.

One-line description, for a card or a feed. Null where the author wrote none.

The post itself, as markdown.

Path of the hero image on the assets CDN, or null. Prefix it with the assets host to fetch.

Editorial category, e.g. guides. Null where the post has none.

Always published on these endpoints: a draft is not served publicly.

When the post was published, which is what the list orders by. Null on a post never given a date.

When the post was first written, YYYY-MM-DD HH:MM:SS in UTC. Not the publication date: postedAt is.

When the post was last edited, YYYY-MM-DD HH:MM:SS in UTC.

Current page number

Items per page

Total matching records (Builder and above)