favi REST versioning

favi versions the HTTP API in the URL path. The current version is 1 at /api/v1/. Unversioned /api/* paths are stable aliases of /api/v1/* and are not deprecated. Agents should prefer /api/v1/ in new integrations. An optional API-Version: 1 request header is documented in the OpenAPI spec; the path is authoritative.

Deprecation policy

Breaking changes ship as /api/v2/ (and later). When a version is retired, every response for that version includes Deprecation: true and Sunset: <HTTP-date> (RFC 8594) for at least 90 days before the path is removed. v1 currently sends neither header. See /openapi.json and GET /api/v1.