---
title: "Admin Catalog Updates"
method: GET
path: "/v1/ai-models/admin/catalog-updates"
tags: ["ai-models"]
---

# Admin Catalog Updates

`GET /v1/ai-models/admin/catalog-updates`

## Query parameters

- `refresh` boolean — Bypass the five-minute catalog cache

## Response `200`

Successful Response

- CatalogUpdatesResponse
  - `checked_at` string, date-time, required
  - `cached` boolean, required
  - `source_url` string
  - `catalog_model_count` integer, required
  - `attention_count` integer, required
  - `items` CatalogUpdateItem[], required
    - `model_id` string, required
    - `model_name` string, required
    - `provider` string, required
    - `external_model_id` string, nullable
    - `availability` 'listed' | 'not_found' | 'unmapped' | 'router', required
    - `comparison` 'checked' | 'unknown' | 'not_applicable', required
    - `findings` string[]
    - `current` CatalogModelDetails
      - `external_model_id` string, required
      - `name` string, required
      - `url` string, required
      - `created_at` string, date-time, nullable
      - `retirement_date` string, date, nullable
      - `context_window` integer, nullable
      - `input_price_per_1m` number, nullable
      - `output_price_per_1m` number, nullable
      - `input_modalities` string[]
      - `supported_parameters` string[]
    - `days_until_retirement` integer, nullable
    - `used_by_routers` string[]
    - `suggestions` ModelSuccessorSuggestion[]
      - `model` CatalogModelDetails, required
        - `external_model_id` string, required
        - `name` string, required
        - `url` string, required
        - `created_at` string, date-time, nullable
        - `retirement_date` string, date, nullable
        - `context_window` integer, nullable
        - `input_price_per_1m` number, nullable
        - `output_price_per_1m` number, nullable
        - `input_modalities` string[]
        - `supported_parameters` string[]
      - `reason` string, required
      - `compatibility_notes` string[]
      - `existing_model_ids` string[]
    - `notes` string[]
  - `warnings` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-10-02** `650f7a88fb5e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kodik/apis/kodik-api/changes/v1/ai-models/admin/catalog-updates/get.md)

---

[API](https://skmtc.dev/kodik/apis/kodik-api.md) · [All operations](https://skmtc.dev/kodik/apis/kodik-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kodik/apis/kodik-api/revisions/650f7a88fb5e?raw)