Skip to main content
PUT
Change post status
Moving a draft to schedule runs the checks Create a post runs for a scheduled post, including the length and media rules a draft skipped. A draft that fails them answers 400 with the channel name and the reason, for example Acme community: channel should not be null or undefined, and stays a draft.
schedule keeps the post’s stored date. If that date has already passed, the post publishes at once. Check the date in List posts first, and change it in the app when it is in the past.
A post that is already published, or failed, cannot change status. To publish a draft at a new time, change its date in the app, or send it again with Create a post and its value[].id.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Path Parameters

id
string
required

The post's id

Body

application/json
status
enum<string>
required

New status for the post

Available options:
draft,
schedule

Response

Post status updated successfully

id
string
state
enum<string>
Available options:
DRAFT,
QUEUE
Last modified on September 23, 2026