# API versioning and deprecation policy

The public REST catalog is versioned in its URL under `/wp-json/nova/v1/` and `/wp-json/wc/store/v1/`.

Backward-incompatible changes are released under a new version. Existing versions remain supported for at least 12 months after a successor is published.

When an operation is deprecated, responses include `Deprecation: true` and a `Sunset` HTTP date. Clients should migrate before the sunset date. A `Link` header may point to replacement documentation.

Current API contract: [OpenAPI 3.1](https://followersya.com/openapi.json). Support: [https://followersya.com/auth.md](https://followersya.com/auth.md).
