Skip to main content
PATCH

Overview

Changes the publish time or the post details of a scheduled post that has not been published yet. A new scheduledDateTime reschedules the publish: the post goes out at the new time, not the old one. A post that failed can be given a new time to try again; its status stays failed until it publishes. Send at least one of the two fields. platformData takes the same fields as in Schedule Video, with the same per-platform use, and is merged into what is stored: send only the fields you want to change.

Errors

Authorizations

x-api-key
string
header
required

Path Parameters

scheduleId
string
required

The scheduleId returned by /v1/schedule/create

Body

application/json
scheduledDateTime
string<date-time>

New publish time: ISO 8601 in UTC with a Z suffix (for example 2026-10-06T09:00:00Z). Must be in the future.

platformData
object

Post details. Unknown keys are dropped. Each platform uses only some of them: YouTube uses title, description, tags and privacyStatus; TikTok uses title and privacyStatus (public posts for everyone, private and unlisted for only you, as TikTok has no unlisted; duet, stitch and comments off); Instagram uses caption. Merged into the stored values: send only the fields you want to change.

Response

Schedule updated

success
boolean
message
string
data
object