Skip to content
ForgeCastDocs

Changelog

What changed in the developer API and the overlay document format.

October 2026

  • The marketplace. New: GET /market, /market/:slug and /market/:slug/preview; inventory items carry itemKind and a theme's members. The overlay document (still schema: 1, additive) gains kind (overlay or widget), any canvas size from 1 to 8192, the settings in vars with {{key}} variables and bindings, picture settings ({ "kind": "var", "key": … }), and particles layers. GET /catalog/overlays lists only overlays. Documents without any of this are unchanged.
  • The sound catalog. New: GET /sounds, /sounds/categories, /sounds/:soundId and /sounds/:soundId/audio, with a new API key scope sounds:read. Existing keys don't have it; create a new key to use it.
  • v1 introduced: catalog, inventory, overlays, API keys with scopes, a per-account rate limit (10 requests a minute), and the desktop app OAuth flow.
  • Desktop sign-in also accepts the forgecast://auth/callback deep link as redirect_uri (the desktop app uses it); loopback redirects still work. New: the app updater endpoint GET /api/app/update/{target}/{arch}/{current}.
  • Groups and keyframes. The overlay document (still schema: 1, additive) gains group layers and groupId, and the manual Keyframes block the editor writes. Documents without them are unchanged. Brand logos in the editor are ordinary shape: "path" layers.

On this page