Skip to main content
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

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.
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.
Breaking changes would ship under a new path prefix.

Staying current

The machine-readable spec is the source of truth for the contract: Questions or integration issues: spencer@kettio.com.