Publications

List publications

get/publications

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/publications
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Query parameters

workspace_idstring required

Workspace ID

statusstring

Optional status filter

activity_bucket'scheduled' | 'published' | 'failed' | 'draft'

Optional Publication activity bucket filter

content_profilestring

Optional content profile filter

platformstring

Optional destination platform filter

searchstring

Case-insensitive title or source-text search

cursorstring

Opaque cursor for stable newest-first pagination

created_fromstring

Include publications created at or after this RFC3339 timestamp

created_beforestring

Include publications created before this RFC3339 timestamp

calendar_fromstring

Include calendar occurrences at or after this RFC3339 timestamp

calendar_beforestring

Include calendar occurrences before this RFC3339 timestamp

limitinteger

Limit, default 50

offsetinteger

Offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

actual_run_atstring
audiencestring
content_profilestring required
created_atstring required
created_bystring required
creation_presetstring required
creation_source'web' | 'api' | 'sdk' | 'mcp' | 'cli' | 'autopost' | 'unknown' required

Low-cardinality channel that created the Publication

failure_dismissed_atstring
goalstring
idstring required
intentstring required
metadataobject required
random_delay_inheritedboolean required
random_delay_minutesinteger required
review_epochinteger
review_idstring
review_state'pending' | 'approved' | 'changes_requested' | 'needs_review'
revisioninteger required
scheduled_atstring
social_set_idstring
source_textstring required
source_urlstring
statusstring required
titlestring required
updated_atstring required
workspace_idstring required

Example response

[
  {
    "$schema": "https://example.com/api/v1/schemas/PublicationResponse.json"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.