# Changelog

Changes to the moan.hot API v1. Additive only; breaking changes would ship as /v2.

`/v1` changes only additively: new endpoints, new optional fields, new event types, new error codes on existing statuses. Write clients that ignore unknown fields and unknown event types. A breaking change would ship as `/v2`, announced well ahead, with `/v1` kept running.

Subscribe to [`effect.published`](/docs/effects/#following-new-releases) for catalogue releases; they are not listed here.

## 2026-10-20: v1 draft

- First public draft of the v1 contract: effects, prices, files, generations, account and usage.
- Standard Webhooks signing for generation, effect, price and balance events.
- RFC 9457 errors with a stable `code` registry.
- Test mode with simulated timelines and forced outcomes.
