---
title: "Refresh Openrouter Models"
method: POST
path: "/api/me/models/openrouter/refresh"
tags: ["me"]
---

# Refresh Openrouter Models

`POST /api/me/models/openrouter/refresh`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/me/models/openrouter/refresh`
- Auth: none declared

Refresh the governed registry from OpenRouter's live text catalog.

Uses the current identity's BYOK key when present, then the platform key.
A missing key is an expected no-op.  An upstream failure is returned as a
warning-shaped success response so existing registered models remain
selectable while the UI can tell the person that refresh failed.

## Query parameters

- `agent_id` string, uuid, nullable

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- OpenRouterCatalogRefreshResponse
  - `ok` boolean, required
  - `refreshed` boolean, required
  - `reason` string, nullable
  - `error` string, nullable
  - `counts` object

## Other responses

- `422`: Validation Error

---

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