Documentation menu

api

Idempotency

What is idempotent today, and what an idempotency key will add.

Last updated 2026-07-10 · beta

Today

  • Planning calls (story_intelligence_report, director_prompt_plan, list_*) are read-only and safe to retry freely.
  • set_brand_profile is idempotent per brand_id: repeating the same request converges to the same state.
  • Connect grants are one-time by construction: a grant delivers its key exactly once and cannot be replayed.
  • Publish confirmation is explicit per call; a retried prepare posts nothing.

Generation retries

During the non-metered beta, a retried generate_video produces a new outcome and costs nothing. Before metered billing goes live, an Idempotency-Key header ships so a network-level retry can never double-charge; that requirement is part of the billing gate, tracked on the build board.

Idempotency | Cadenza Docs