---
title: "List models"
method: GET
path: "/v1/agents/{agent}/models"
tags: ["Agent credentials"]
---

# List models

`GET /v1/agents/{agent}/models`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/agents/{agent}/models`
- Auth: HTTP bearer

Uses the workspace selection or harness credential priority. Before workspace creation, pass method and scope to preview a connected inference provider. Returns provider editability and an optional default model; null requires explicit selection.

## Path parameters

- `agent` 'claude' | 'codex' | 'opencode' | 'pi', required

## Query parameters

- `workspaceId` string, uuid
- `method` string
- `scope` 'org' | 'user'
- `query` string
- `page` integer
- `limit` integer

## Response `200`

Paginated model catalog

- ModelCatalogResponse
  - `source` 'aster' | 'openrouter' | 'opencode-go' | 'static' | 'openai-compatible' | 'ollama', required
  - `models` object[], required
    - `id` string, required
    - `displayName` string, required
    - `description` string
    - `contextWindow` integer
    - `capabilities` string[]
  - `readOnly` boolean
  - `defaultModel` string, nullable: Default model ID, or null when explicit model selection is required.
  - `page` integer, required
  - `total` integer, required
  - `limit` integer, required
  - `totalPages` integer, required

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `502`: The provider catalog could not be loaded.

---

[API](https://skmtc.dev/replicas/apis/replicas-api.md) - [All operations](https://skmtc.dev/replicas/apis/replicas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/replicas/apis/replicas-api/revisions/2703ac1c9cb7?raw)