Documentation menu

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

  1. Prepare: publish_video without 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.
  2. Confirm: call again with confirmations naming each platform you approve. Only platforms with confirm: true post; 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.

Publish a video | Cadenza Docs