Models
List model catalog entries
Lists the model catalog. Requires permission agents:read.
GET
List model catalog entries
The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
GET /api/v2/models/list returns the catalog entries in data, with meta.requestId, in one response without limit, or in pages of limit with cursor. The catalog is global: every caller with agents:read sees the same entries.
Optional parameters filter like the Console’s models page: provider and status (active, deprecated, preview; each repeatable), isActive (true or false) and search (matched against the model id, display name, description and tags). status=active means active and neither deprecated nor preview. sort=name orders by display name (else model id); createdAt and updatedAt order newest first. Without sort, the catalog order is kept. A repeated isActive, search or sort, or an unknown value, is 400 bad_request.
Each item in data is a Model object: exactly modelId, provider, displayName, contextWindow, maxTokens, isActive, and status. Every field is present; displayName, contextWindow, maxTokens, and status are null when the catalog records no value. isActive and status are recorded catalog state, not a guarantee that an agent can run on the model.
Pricing, pricing provenance, provider attributes, synchronization details, internal identifiers (including the former id), and agent usage (assignedAgents, agentCount) are not returned. See Models.Authorizations
Query Parameters
Response
Model list

