# Aloha Fungi public API policy

The public Agent API uses major versioning in the URL, beginning with `/api/v1`.

- Additive fields and new read-only endpoints may be introduced within the current major version.
- Breaking request or response changes require a new major URL such as `/api/v2`.
- A deprecated endpoint will return `Deprecation: true`, a `Link` header with `rel="deprecation"`, and a standards-based `Sunset` date.
- Aloha Fungi will normally provide at least 90 days between the first deprecation signal and sunset.
- Security or legal emergencies may require a shorter window. The Developer Hub will explain the exception.

Clients should ignore unknown additive response fields, read live prices and availability for every decision, and use the `RateLimit` headers to pace requests. The current policy and machine contract are linked from `https://alohafungi.com/developers` and `https://alohafungi.com/openapi.json`.