# Changelog and versioning

## Versioning

The API is versioned in the path: `/v1`. Within `v1`, changes are additive. New fields and new endpoints may appear; existing fields keep their meaning. A breaking change would ship under a new version, never inside `v1`.

Every response carries an `X-Ziffi-Api-Stability` header while the graph quality is being proven. Read it if you want to gate on stability.

## Deprecation policy

When a field or endpoint is retired, it is announced here first, marked deprecated in the OpenAPI spec, and kept working for a notice period before removal.

## Changes

**2026-07: Developer platform preview**

- Developer portal at `/dev` with an interactive reference, playground, and MCP tester.
- Documentation at `/docs`.
- Access model: a free tier per IP (no signup) plus a higher rate limit when you sign up and send an API key.
- Self-serve accounts: sign up, log in, and manage your keys from `/dashboard`.
- Curated OpenAPI 3.1 at `/openapi.json` with grouped tags and the `X-Ziffi-Key` security scheme.
- Health probes at `/health/live` and `/health/ready`; Prometheus metrics at `/metrics`.

**Earlier**

- Three-mode search (hybrid, semantic, lexical), live price, recommendations, brands, categories, and the MCP server went live.

## Next steps

- [Get started](#/get-started): the five minute path.
- [API reference](#/reference): the current surface.