Skip to main content
PATCH
Change a scheduled post

Authorizations

Authorization
string
header
required

An API key from Settings, API & MCP: pm_live_...

Path Parameters

id
string<uuid>
required

The post's id.

Body

application/json

Changes to a post still waiting for its time. Fields left out stay as they are.

content
string
Maximum string length: 63206
captions
object
account_ids
string<uuid>[]
Maximum array length: 50
scheduled_at
string<date-time>

A new time.

publish_now
boolean

Send it now instead of at its time.

settings
object

Network fields to change: youtube_tags, youtube_made_for_kids, youtube_privacy, tiktok_options, reddit_title, reddit_subreddit, reddit_flair_id, always_post.

series
enum<string>

For a repeating post: this time only, or this and every later one.

Available options:
this,
all
repeat
object | null

A new repeat from this post on, or null to stop after it.

expected_updated_at
string<date-time>

The post's updated_at as you read it. Refused when it changed since.

Response

The post as it is now.

post
object
required

A post: sent, scheduled, waiting or failed.

warning
string
youtube
object[]

What happened to videos already on YouTube's schedule.