Posts

Change content, files, time or networks of a post that has not gone out

Only the fields sent change. Giving a draft a time schedules it (posts:publish). Targets cannot change once any has started going out (409 targets_locked).

patch/posts/{id}

Request

  • Base URL: https://preflight.social/v1
  • URL: https://preflight.social/v1/posts/{id}
  • Auth: HTTP bearer

Request body

contentstring

The text. On YouTube it is the description unless youtube.description is set.

linkUrlstring uri
mediaIdsstring[]

Files in order; they must be ready.

altTextsstring[]

Alt text per file, same order as mediaIds.

scheduledAtstring date-time

One instant for every channel. Up to five minutes in the past counts as now; older is refused with 400 scheduled_in_past (send publishNow to publish at once).

scheduledLocalstring

The same wall-clock time read in each channel's own zone.

queueboolean

Each channel takes its next free slot from its posting schedule.

publishNowboolean
saveAsDraftboolean

Park it without a time. Needs only posts:write.

Response

The post as it is now.

idstring uuid
status'draft' | 'scheduled' | 'publishing' | 'done' | 'canceled'
contentstring
linkUrlstring nullable
mediaIdsstring[]
altTextsstring[]
scheduledAtstring date-time nullable
approvalStatestring nullable

pending, approved or changes when a client approval link exists.

createdAtstring date-time
updatedAtstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.