Skip to main content
GET
List Posts

Authorizations

Authorization
string
header
required

Send an account API key in the Authorization: Bearer <key> header.

Headers

OpenPMM-Request-Id
string

Optional request ID. OpenPMM returns this value when it is valid. Otherwise, OpenPMM creates a request ID.

Maximum string length: 128

Path Parameters

workspace_id
string
required

Unique workspace ID.

Example:

"ws_01JABCDEF"

Query Parameters

limit
integer
default:25

Maximum number of items to return.

Required range: 1 <= x <= 100
after
string

The next_cursor value from the previous page. Send this value without changes.

view
enum<string>
default:all

Post view to return. Use "failed" to list posts that need attention, the same set the "Failed" tab shows.

Available options:
all,
drafts,
scheduled,
published,
attention,
failed
channel
enum<string>

Return only entries for this publishing channel.

Available options:
bluesky,
facebook,
instagram,
threads,
mastodon,
x,
linkedin,
tiktok,
youtube
group
string

Return only entries with this post group value.

Required string length: 1 - 200
destination_id
string

Return only Posts for this Destination.

Required string length: 1 - 200
state
enum<string>

Return only Posts in this exact state.

Available options:
draft,
preparing,
scheduled,
ready,
processing,
awaiting-provider,
published,
failed,
needs-attention,
cancelled,
missed
created_after
string<date-time>

Return Posts created after this time.

scheduled_before
string<date-time>

Return Posts scheduled before this time.

include
enum<string>

Set to attempts to include sanitized attempt history.

Available options:
attempts

Response

A page of posts.

data
object[]
required
has_more
boolean
required
Example:

false

next_cursor
string | null
required
Example:

"eyJ2ZXJzaW9uIjoxfQ"