Skip to main content
POST
Retry 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

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
If-Match
string
required

The current ETag for the resource. This value prevents an update to an old version.

Path Parameters

workspace_id
string
required

Unique workspace ID.

Example:

"ws_01JABCDEF"

post
string
required

Unique Post ID.

Example:

"send_01JABCDEF"

Body

application/json
confirmed
boolean
required
acknowledge_duplicate_risk
boolean

Required when retry_safety is may_duplicate. Verify the provider before you set this field.

Response

The post queued for retry.

id
string
required

Unique Post ID.

Example:

"send_01JABCDEF"

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

A value that groups related posts.

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

"launch-2026-08"

channel
enum<string>
required
Available options:
bluesky,
facebook,
instagram,
threads,
mastodon,
x,
linkedin,
tiktok,
youtube
Example:

"x"

state
enum<string>
required
Available options:
draft,
preparing,
scheduled,
ready,
processing,
awaiting-provider,
published,
failed,
needs-attention,
cancelled,
missed
editable
boolean
required

Whether you can update the Post content. A scheduled Post keeps its assets and thread structure locked.

terminal
boolean
required

True when the Post can no longer change state. Poll only while this value and action_required are false.

action_required
boolean
required

Whether a person or agent must choose the next action.

next_action_at
string<date-time> | null
required
Example:

"2026-08-09T12:00:00.000Z"

retry_safety
enum<string>
required
Available options:
safe,
may_duplicate,
not_applicable
available_actions
enum<string>[]
required
Available options:
update,
delete,
publish,
cancel,
reschedule,
retry,
retry_with_duplicate_risk
version
integer | null
required
Required range: x >= 1
payload
object
required
asset_ids
string[]
required
Maximum array length: 100

Unique asset ID.

destination_id
string | null
required

Unique destination ID.

Example:

"dest_01JABCDEF"

scheduled_at
string<date-time> | null
required
Example:

"2026-08-09T12:00:00.000Z"

time_zone
string | null
required
Example:

"Europe/Berlin"

schedule_mode
enum<string> | null
required
Available options:
now,
exact,
queue
queue_local_date
string<date> | null
required
queue_window_id
string | null
required
attempt_count
integer
required
Required range: x >= 0
deferred
object | null
required

The future time when OpenPMM can try the Post again. This value is null after that time.

last_error
object | null
required
created_at
string<date-time>
required
Example:

"2026-08-09T12:00:00.000Z"

updated_at
string<date-time>
required
Example:

"2026-08-09T12:00:00.000Z"

published_at
string<date-time> | null
required
Example:

"2026-08-09T12:00:00.000Z"

cancelled_at
string<date-time> | null
required
Example:

"2026-08-09T12:00:00.000Z"

missed_at
string<date-time> | null
required
Example:

"2026-08-09T12:00:00.000Z"

receipts
object[]
required
destination
object | null
required
assets
object[]
required
attempts
object[]

Sanitized attempt history. Present only when include=attempts.