Changelog

Contract-relevant changes — new endpoints, new error codes, limit changes, deprecations, and the launch itself — are announced here. Entries are newest-first.

2026-10-25 — Venues guides (preview)

• Preview: not yet available. The venue agent guide, the booking widget and the import format describe Mouve for Venues ahead of launch.
• JSON Schemas: /schemas/venue-setup-v1.json and /schemas/venue-import-v1.json.

2026-08-29 — Documentation preview

• This site is published ahead of the API. Nothing under /public/v1 is callable yet; the pages here specify the launch contract so integrators can build against it early.
• The MCP server at api.mouve.it/mcp is available for personal assistant use.
• Until launch, the contract described here may still change; any change will be recorded in this changelog. After launch, the policy below applies.

Versioning and deprecation

This policy is part of the API contract:

• The major version is in the path (/public/v1). Within a major version, these are breaking and will not happen: removing, renaming, or retyping a response field; adding a required request field; changing an error's status or code; raising a required scope; changing cursor semantics; narrowing a closed enum (audience is closed).
• Non-breaking and expected: new endpoints, new optional request fields, new response fields, new error codes (appended to the registry). Send only documented request fields — unknown request fields are rejected — and ignore unknown response fields.
• Deprecations: announced here and by email to affected app owners; affected endpoints then serve Deprecation, Sunset, and Link headers for at least 180 days before returning 410 ENDPOINT_RETIRED. A whole major version sunsets no sooner than 365 days after its successor is generally available.
• Stability tiers: endpoints marked Beta (x-mouve-stability: beta in the OpenAPI document) may change with changelog notice but without the 180-day window. Everything else is GA.
• Webhooks are not yet available — watch this changelog; polling with cursors is the supported pattern today.