---
title: "Report comparison counts per handle [first-party]"
method: PUT
path: "/catalog/comparison_counts"
tags: ["catalog"]
---

# Report comparison counts per handle \[first-party\]

`PUT /catalog/comparison_counts`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/catalog/comparison_counts`
- Auth: HTTP bearer

For the first-party client that records side-by-side comparison verdicts; any other token is refused with 403. The body is a full snapshot taken at `reported_at`: each handle is set to its totals and a handle left out is removed, so sending the same snapshot again changes nothing and an older one never overwrites a newer one. The totals reach `stats.comparisons` and `stats.wins` on the next hourly recount. Answers 503 `not_migrated` until the platform's table is in place.

## Request body

- object
  - `reported_at` string, date-time, required
  - `counts` object[], required
    - `handle` string, required
    - `comparisons` integer, required
    - `wins` integer, required

## Response `200`

OK

- object
  - `handles` integer, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/catalog/comparison_counts/put.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)