Skip to main content
POST
Generate Inbox Draft

Authorizations

Authorization
string
header
required

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

Body

application/json

Generate and persist a new Inbox draft from a customer topic/seed.

topic
string
required
Required string length: 3 - 1200
idempotency_key
string
required
Required string length: 8 - 120
signal_ref
string | null

Optional source-card ref from /content/signals/suggestions. When set, generation is grounded in that org-scoped signal's copied facts.

Required string length: 3 - 300
media_asset_id
string<uuid> | null
media_asset_ids
string<uuid>[]
Maximum array length: 20
platforms
enum<string>[] | null

Target platforms for the draft. Omit to use all default platforms. LinkedIn and X are generated by default today.

Required array length: 1 - 2 elements
Available options:
linkedin,
x

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