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_profileis idempotent perbrand_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.