Skip to main content
POST

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 when you publish or schedule a post. Optional when you create a draft.

Required string length: 1 - 200

Path Parameters

workspace_id
string
required

Unique workspace ID.

Example:

"ws_01JABCDEF"

Body

application/json
posts
object[]
required
Required array length: 1 - 100 elements
confirmed
boolean

Set to true when you publish or schedule. Omit this field when you create a draft.

when
default:now

Use now to publish, draft to save a draft, queue to use the next posting window, or an ISO 8601 timestamp to schedule. A timestamp must include a UTC offset.

Available options:
now,
draft,
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"

group
string

A value that groups related posts.

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

"launch-2026-08"

Response

An idempotent replay of the existing Post set.

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