Seasonal Format: a new slug per season, or edit the same one in place?

If an old season's look must stay reproducible, create a new slug for each season. If you only ever want the current look, edit one Format in place. The Contents API commits changes but offers no revert, blame or history browsing, which makes in-place edits one-way unless you keep your own copy.

What each path gives you

POST /v1/formats creates a Format in your key's workspace with a slug and title, and returns skl_ ids and a vanity_invoke_url. A slug that your workspace already has is 409 skill_slug_taken, and a slug that a Format by Sume holds is 409 skill_slug_reserved.

A middle path

Edit in place for small copy changes, and fork a new slug when the structure of the recipe changes. Whichever you pick, store the receipt's format.version with every output so you can tell which edit made which video.

• Keep the package files in your own git repository; the API is a delivery path, not a history.
• Persist the opaque skl_ invoke_url; renamed handles keep resolving for 90 days.
• Do not edit during a running queue unless you accept that items that start later read the newer package.

What to record either way

Whatever you choose, keep three things with each output: the Format invoke_url, the format.version from the receipt, and the package_sha you committed. With those, you can rebuild the state of a recipe from your own repository.

Also set the spend cap deliberately. A Format that never named a cap reports a platform default of $400, and a run can name its own cap up to $500, so a seasonal Format is a good moment to set a lower per-run number on the Format itself.

Think about who calls the Format too. If other people or systems call it by slug, a new slug means every caller must change, while an in-place edit changes behavior under callers who did not ask for it. Decide which surprise you can live with before the season starts.

Tradeoff

A slug per season costs setup and clutter, but it makes the audit trail honest. In-place editing is quicker, and loses the old recipe unless you saved it yourself.