Skip to main content
POST
Schedule Inbox Draft

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

draft_id
string<uuid>
required

Body

application/json

Schedule a draft to publish at a future instant.

Two input shapes (exactly one): an ABSOLUTE scheduled_at (tz-aware), OR a per-tenant wall-clock local_datetime (naive) + IANA timezone. The server resolves the wall-clock via ZoneInfo, rejects past-time + DST-gap, and enforces the per-day cap. Scheduling enrolls the draft into the dispatch queue (E4.1b).

scheduled_at
string<date-time> | null
local_datetime
string<date-time> | null
timezone
string | null
provider_account_id
string | null

LinkedIn OAuth account to pin for this scheduled post. Omit to snapshot the org's LinkedIn default when the dispatch row is created.

Required string length: 1 - 255
linkedin_account_id
string | null
Maximum string length: 200
x_account_id
string | null
Maximum string length: 200

Response

Successful Response

A single Inbox draft card (list-row + get + action responses).

NEVER includes dedupe_key (internal CAS key). voice_config_snapshot is the voice config stamped at generate time (E3.1); the UI may render it read-only.

id
string<uuid>
required
status
enum<string>
required
Available options:
pending,
approved,
denied,
snoozed,
scheduled
created_at
string<date-time>
required
updated_at
string<date-time>
required
linkedin_body
string | null
x_body
string | null
media_asset_id
string<uuid> | null
media_asset_ids
string<uuid>[]
scheduled_at
string<date-time> | null
voice_config_snapshot
Voice Config Snapshot · object | null
source
string | null
topic
string | null