Publications

Create a publication

post/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

Headers

Idempotency-Keystring

Replay key scoped to the caller, Workspace, and operation

Request body

$schemastring uri

A URL to the JSON Schema for this object.

audiencestring

Target audience

content_profilestring required

Content profile

creation_preset'post' | 'thread' | 'story' | 'short_video' | 'video'

Starter preset; destination renditions own their formats

goalstring

Publication goal

intent'post' | 'thread' | 'story' | 'short_video' | 'video'

Deprecated compatibility alias for creation_preset

metadataobject

Publication metadata

random_delay_minutesinteger

Optional random schedule delay in minutes (±N); omit to inherit the Workspace setting when scheduled

scheduled_atstring date-time

Optional schedule time

social_account_idsstring[] nullable

Accounts to create default renditions for

social_set_idstring

Social Set used to initialize the snapshotted destinations

source_textstring required

Canonical source text

source_urlstring

Source URL for link shares

titlestring required

Internal publication title

workspace_idstring required

Workspace ID

Example request

{
  "$schema": "https://example.com/api/v1/schemas/CreatePublicationBody.json"
}

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.