← Corpus / dididecks-ai / sitemap

May 15, 2026 dididecks-ai shipped

/api/slide-rank — read + write per-slide classifier state into the consumer's audits file

Dev-only GET/POST over `data/audits/slides.json` — `'pending'` is never persisted; posting it deletes the entry. 404s in production builds.

Path: sitemap/routes/api-slide-rank.md
Authors: Michael Staton

/api/slide-rank

Storage shape (schema 1)

{
  "schema": 1,
  "ranks": {
    "<deckSlug>/<variantSlug>/<slot>": {
      "status": "urgent-redo" | "non-urgent-could-be-better" | "passable" | "perfect",
      "rankedAt": "<ISO-8601>",
      "rankedBy": "founder",
      "notes": null
    }
  }
}

Composite key deckSlug/variantSlug/slot via buildRankKey() so cross-deck rank data lives in one file per consumer.

Status

✅ Dev-only POST + GET working.
⚠️ Per-client database (V2) is a Phase D concern — public/share-tier ranks need real persistence, auth, telemetry. Today everything is local-dev only.

[[../components/SlideRankPill]] — primary consumer.
[[toc]] — build-time reader.
[[api-slide-decompose]] — sibling write-API.