# Aloha Fungi B2B API Versioning and Deprecation Policy

## Current version

The current public REST API version is `v1`. Canonical endpoint paths begin with `https://b2b.alohafungi.pl/api/v1/`.

Unversioned `/api/` REST paths remain compatibility aliases. They are not currently deprecated. New integrations should use `/api/v1/` paths.

The MCP server version is published separately in its server manifest and initialization response because MCP protocol negotiation is independent of REST URL versioning.

## Compatibility

Backward-compatible additions can ship within `v1`. Removing or changing a documented field, meaning, validation rule or side effect requires a new major API version.

## Deprecation and removal

Aloha Fungi B2B will provide at least 12 months of notice before removing a public REST version. A deprecated response will include:

- a `Deprecation` header following RFC 9745;
- a `Sunset` header following RFC 8594 when a removal date is known;
- a `Link` header with `rel="deprecation"` pointing to migration instructions.

The OpenAPI specification, developer documentation and `llms.txt` will identify the replacement version and migration path. No public endpoint carries a deprecation or sunset header at this time.

Questions: https://b2b.alohafungi.pl/kontakt/