← Docs

API versioning

Meridian uses URI-path versioning. Every endpoint is prefixed with a version segment that signals the contract you are integrating against.

Current version

/v1

Stable. No breaking changes will land on /v1 without a deprecation window.

Breaking changes

When a change cannot be delivered compatibly — field removal, semantic shift, auth flow rewrite — we ship it under a new version segment.

BeforePOST /v1/licenses/verify
AfterPOST /v2/licenses/verify

Deprecation policy

  • Deprecated versions return the Sunset header.
  • Minimum 90-day notice before a deprecated version is turned off.
  • Email warnings go to the account owner on file.

Need help migrating? Open a ticket.