sourceDraftIdstring
Immutable original draft ID. New approvals preserve this as id; legacy audited approvals may resolve an older ID to a different canonical id.
snapshotstring
Computed full-state approval fence returned by GET. Includes media, options and metadata.
state'draft' | 'awaiting_approval' | 'rejected' | 'queued' | 'scheduled' | 'processing' | 'partial' | 'published' | 'failed' required
createdAtstring date-time required
clientIdstring
Stable machine principal that created the post. Absent for human-created dashboard posts.
surface'dashboard' | 'api' | 'agent'
Where the post was created, independent of the principal identity.
scheduledAtstring date-time nullable required
timezonestring
IANA timezone the caller scheduled in, when they named one.
scheduledAtLocalstring
Wall-clock time in timezone, computed on read. Not stored.
warningsstring[]
Advisory notes from create or edit, for example PNG converted to JPEG for TikTok.