guides
Publish a video
Preview per platform, confirm each destination explicitly, and let nothing post on its own.
Last updated 2026-07-10 · beta
The two-step flow
- Prepare:
publish_videowithout confirmations returns per-platform previews: derived aspect ratio, a caption draft in the platform's style, and hashtags trimmed to the platform's conventions. Nothing posts. - Confirm: call again with
confirmationsnaming each platform you approve. Only platforms withconfirm: truepost; unconfirmed platforms are skipped.
confirm request fragment
{
"asset_id": "…",
"confirmations": [
{ "platform": "tiktok", "confirm": true },
{ "platform": "youtube", "confirm": true }
]
}The two gates
- Safety gate: an asset without a provenance manifest cannot be published at all.
- Confirm gate: posting is never autonomous. No confirmation, no post.
Per-platform results
Each platform returns its own success or failure; one platform failing never drops the others. Every publish is written to the audit log.
Beta: Platform connections use OAuth at setup and tokens are hashed at rest. The final HTTP post to each platform is an open seam awaiting per-platform app credentials; the preparation, gating, and confirmation flow is the production path. See the build board.