---
title: "Read changes since an installed coding-agent version"
method: GET
path: "/api/v1/coding-agent-upgrade"
tags: ["Coding agents"]
---

# Read changes since an installed coding-agent version

`GET /api/v1/coding-agent-upgrade`

## Request

- Base URL: `https://cheapestllmapi.com`
- URL: `https://cheapestllmapi.com/api/v1/coding-agent-upgrade`
- Auth: none required

Matches an exact archived version or release ID within one official source. Uses publication order rather than inferred semantic versions. Missing or ambiguous baselines are explicit. Inspect data.pagination, source freshness, and abbreviated source notes.

## Query parameters

- `installed` string, required
- `channel` 'stable' | 'all'
- `agent` string, required
- `source` string
- `offset` integer
- `limit` integer

## Response `200`

Source-linked upgrade comparison

- object
  - `meta` object, required
    - `apiVersion` 'v1', required
    - `generatedAt` string, date-time, required
    - `refreshIntervalHours` integer, required
    - `staleAfterHours` integer, required
    - `completeness` 'complete' | 'partial', required
    - `notes` string, required
  - `data` object, required
    - `agent` object, required
      - `compatibility` object, required
        - `reviewedAt` string, date, required
        - `byok` 'supported' | 'limited' | 'unverified', required
        - `billing` string[], required
        - `billingDetail` string, required
        - `models` string, required
        - `providers` string[], required
        - `setup` string, required
        - `limitations` string, required
        - `evidence` object[], required
          - `label` string, required
          - `url` string, uri, required
        - `calculatorExamples` object[], required
          - `label` string, required
          - `modelSlug` string, required
          - `providerSlug` string, required
          - `sourceUrl` string, uri, required
          - `url` string, required
      - `sources` object[], required
        - `sourceId` string, required
        - `label` string, required
        - `url` string, uri, required
        - `lastAttemptAt` string, date-time, nullable, required
        - `lastSuccessAt` string, date-time, nullable, required
        - `error` 'fetch' | 'parse' | 'archive' | 'coverage_drop', nullable, required
        - `history` 'source-history' | 'feed-window' | 'recent-window', required
        - `observedCount` integer, required
        - `archivedCount` integer, required
        - `state` 'unavailable' | 'failed' | 'stale' | 'current', required
      - `slug` string, required
      - `name` string, required
      - `description` string, required
      - `surfaces` string[], required
      - `modelAccess` string, required
      - `website` string, uri, required
      - `changelog` string, uri, required
      - `coverage` string, required
      - `source` union, required
        - object
          - `kind` 'github', required
          - `repository` string, required
          - `tagPattern` string, required
        - object
          - `kind` 'npm', required
          - `packageName` string, required
          - `changelogRaw` string, uri, required
        - object
          - `kind` 'rss', required
          - `url` string, uri, required
        - object
          - `kind` 'changelog', required
          - `format` 'codex' | 'mintlify', required
          - `url` string, uri, required
      - `sourceLabel` string
      - `additionalSources` object[]
        - `id` string, required
        - `label` string, required
        - `source` union, required
          - object
            - `kind` 'github', required
            - `repository` string, required
            - `tagPattern` string, required
          - object
            - `kind` 'npm', required
            - `packageName` string, required
            - `changelogRaw` string, uri, required
          - object
            - `kind` 'rss', required
            - `url` string, uri, required
          - object
            - `kind` 'changelog', required
            - `format` 'codex' | 'mintlify', required
            - `url` string, uri, required
      - `lastSuccessAt` string, date-time, nullable, required
      - `lastAttemptAt` string, date-time, nullable, required
      - `state` 'unavailable' | 'stale' | 'current', required
      - `history` 'source-history' | 'feed-window' | 'recent-window', required
      - `total` integer, required
      - `stableTotal` integer, required
      - `earliest` string, date-time, nullable, required
      - `latest` object, nullable, required
        - `id` string, required
        - `agentSlug` string, required
        - `sourceId` string, required
        - `sourceLabel` string, required
        - `title` string, required
        - `version` string, required
        - `publishedAt` string, date-time, required
        - `url` string, uri, required
        - `prerelease` boolean, required
        - `excerpt` string, required
        - `topics` string[], required
    - `status` 'ready' | 'baseline_not_found' | 'ambiguous_baseline', required
    - `baseline` object, nullable, required
      - `id` string, required
      - `agentSlug` string, required
      - `sourceId` string, required
      - `sourceLabel` string, required
      - `title` string, required
      - `version` string, required
      - `publishedAt` string, date-time, required
      - `url` string, uri, required
      - `prerelease` boolean, required
      - `excerpt` string, required
      - `topics` string[], required
    - `candidates` object[], required
      - `id` string, required
      - `agentSlug` string, required
      - `sourceId` string, required
      - `sourceLabel` string, required
      - `title` string, required
      - `version` string, required
      - `publishedAt` string, date-time, required
      - `url` string, uri, required
      - `prerelease` boolean, required
      - `excerpt` string, required
      - `topics` string[], required
    - `releases` object[], required
      - `id` string, required
      - `agentSlug` string, required
      - `sourceId` string, required
      - `sourceLabel` string, required
      - `title` string, required
      - `version` string, required
      - `publishedAt` string, date-time, required
      - `url` string, uri, required
      - `prerelease` boolean, required
      - `excerpt` string, required
      - `topics` string[], required
    - `topicCounts` object[], required
      - `topic` 'Models' | 'MCP' | 'Security' | 'Performance' | 'Fixes', required
      - `count` integer, required
    - `pagination` object, required
      - `offset` integer, required
      - `limit` integer, required
      - `total` integer, required
      - `hasMore` boolean, required
    - `note` string, required

## Other responses

- `400`: Invalid request, missing resource, or temporary catalog failure
- `404`: Invalid request, missing resource, or temporary catalog failure
- `429`: Invalid request, missing resource, or temporary catalog failure
- `503`: Invalid request, missing resource, or temporary catalog failure

---

[API](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api.md) · [All operations](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cheapestllmapi/apis/cheapest-llm-api-public-data-api/revisions/81b9a3301c5c?raw)