---
title: "Refresh Hosted Models"
method: POST
path: "/api/v1/hosted-providers/{provider}/models/refresh"
tags: ["hosted-providers"]
---

# Refresh Hosted Models

`POST /api/v1/hosted-providers/{provider}/models/refresh`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `Otari-Key`
  - API key in header `x-api-key`

Ask the provider again and offer whatever is newly listed.

Nothing already offered is removed, even when the provider no longer lists
it. New models follow the offer rule, seeded with the community default
price and off when nothing prices them. A seeded price nobody changed moves
with the default. An offered model whose stored price has since been
deleted is seeded again, or switched off where the default does not price
it, even one an operator switched on: a refresh never switches a model on.

## Path parameters

- `provider` string, required

## Response `200`

Successful Response

- HostedModelsRefreshPublic: What a refresh did: the models newly offered, the seeded rates it moved, and the list's new size. Failure is a field rather than a status, for the reason ``HostedAvailableModelsPublic`` gives: the list is still standing, and the panel renders the reason beside it.
  - `added` string[], required
  - `count` integer, required
  - `discovery_unsupported` boolean
  - `error` string, nullable
  - `repriced` string[], required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `b53c45c6d0fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mozilla-ai/apis/otari/changes/api/v1/hosted-providers/:provider/models/refresh/post.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/2c95b115b0a8?raw)