> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kettio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Changes to the Kettio API and documentation.

<Update label="August 2026" description="Rank API v1.1.0">
  **Documentation moved to docs.kettio.com.**

  The developer reference now lives here, generated from the same OpenAPI 3.1 contract the API is
  built against. Request and response schemas come straight from the spec, so the reference cannot
  drift from the implementation.

  Current surface:

  * `POST /api/v1/rank` — batch scoring and ranking, up to 20 assets
  * `POST /api/v1/pairwise` — five-voter blinded panel on explicit matchups
  * MCP server — asset workflow tools for Claude Desktop, Codex, and stdio clients
</Update>

## Versioning

The Rank API is versioned in the URL path (`/api/v1/`). Additive changes — new optional request
fields, new response fields, new enum values for `goal` or `asset_type` — ship within `v1`
without a version bump.

<Warning>
  Parse responses tolerantly. New fields can appear on `ranked[]` and `summary` objects within the
  current version, so a strict schema check that rejects unknown keys will break on an additive
  release.
</Warning>

Breaking changes would ship under a new path prefix.

## Staying current

The machine-readable spec is the source of truth for the contract:

* [Rank API reference](/api-reference/rank) — generated from OpenAPI 3.1
* [Pairwise API reference](/api-reference/pairwise) — generated from OpenAPI 3.1

Questions or integration issues: [spencer@kettio.com](mailto:spencer@kettio.com).