Skip to main content
PUT
Edit or reschedule a post
A change to the prompt, slides, references, catalog item or formats on an AI post discards its images and re-queues generation, which spends the store’s AI credits, so that edit also needs USE_MERCHANT_AI. A pure reschedule does not.

Authorizations

Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side, so never send a shop id.

Path Parameters

id
string
required

The planned post's id (Mongo ObjectId).

Body

application/json

Any subset of the create fields. kind cannot be changed after the post exists.

title
string
prompt
string
caption
string
platforms
string[]
formats
string[]
media
object[]
scheduledAt
string<date-time>
mode
enum<string>
Available options:
auto,
approval
generateAheadHours
integer
Required range: 0 <= x <= 168

Response

The updated post.

Standard Salesive response envelope. The operation-specific payload is carried in data.

status
integer
required
success
boolean
required
message
string
required
data
object

A planned post. kind: "ai" generates its images from prompt; kind: "manual" publishes the files in media.