Posts

Create, schedule, queue or publish a post

Checked against every target network first; a refusal is 422 validation_failed with the issues. Scope posts:write for a draft, posts:publish for anything that goes out. Send an Idempotency-Key header: a retried request returns the first post instead of creating a second.

post/posts

Request

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

Headers

Idempotency-Keystring

Unique per post, e.g. a UUID.

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 Idempotency-Key matched an earlier post, which is returned instead.

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.