List Posts

GEThttps://api.firmreader.com/v1/posts

Retrieve a paginated list of posts. Filter by channel, author, tag, or date range.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

channel_idstring

Filter by channel ID.

author_idstring

Filter by author user ID.

tagstring

Filter by tag.

priority"normal" | "high" | "urgent"

Filter by priority level.

Allowed values: "normal" | "high" | "urgent"

published_afterstring<date-time>

Only return posts published after this timestamp.

published_beforestring<date-time>

Only return posts published before this timestamp.

limitintegerdefault: 20

Number of posts to return per page.

Required range: x >= 1, x <= 100

Default: 20

cursorstring

Cursor for pagination. Use the `next_cursor` from the previous response.

Response

application/json

List of posts

dataarray<object>

data.idstring

Unique post identifier.

data.channel_idstring

Channel the post belongs to.

data.titlestring

Post headline.

data.bodystring

Post content in Markdown.

data.priority"normal" | "high" | "urgent"

Notification priority level.

Allowed values: "normal" | "high" | "urgent"

data.tagsarray<string>

Tags for categorization.

data.authorobject

data.status"draft" | "scheduled" | "published" | "archived"

Current status of the post.

Allowed values: "draft" | "scheduled" | "published" | "archived"

data.published_atstring<date-time>

When the post was published.

data.scheduled_atstring<date-time>

Scheduled publish time, if applicable.

data.cover_image_urlstring<uri>

data.viewsinteger

Number of unique readers.

data.created_atstring<date-time>

data.updated_atstring<date-time>

next_cursorstring

Cursor for the next page. Null if no more results.

has_moreboolean

Whether there are more results.