Skip to main content
POST
Publish 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
Idempotency-Key
string
required

A unique key for this operation. Use the same key when you retry the same request. Different input with the same key returns 409.

Required string length: 1 - 200

Path Parameters

workspace_id
string
required

Unique workspace ID.

Example:

"ws_01JABCDEF"

Body

application/json

Draft Posts and destinations to publish.

confirmed
boolean
required
posts
object[]
required
Required array length: 1 - 100 elements
when
default:now

Use now, queue, or an ISO 8601 timestamp with a UTC offset.

Available options:
now,
queue
time_zone
string
default:UTC

IANA time zone for now or an exact schedule. Omit this field for queue; OpenPMM uses the Workspace time zone.

Example:

"Europe/Berlin"

Response

A replayed publication.

object
string
required
Allowed value: "post_set"
group
string | null
required

A value that groups related posts.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_-]+$
Example:

"launch-2026-08"

posts
object[]
required