---
title: "List your favorite models."
method: GET
path: "/v0/favorite-models"
tags: ["Workspaces"]
---

# List your favorite models.

`GET /v0/favorite-models`

## Request

- Base URL: `https://api.conductor.build` (the document declares no server; this is the origin it was published from)
- URL: `https://api.conductor.build/v0/favorite-models`
- Auth: HTTP bearer

Returns the model configurations the key's user saved as favorites in the Conductor app for the key's organization, in picker order. Available only in cloud organizations; local organizations keep favorite models on each Mac. When `agent` and `model` are omitted, create-workspace uses the first entry if it names a public agent and model and that agent has credentials. Entries can name agents or models the public API doesn't accept.

## Response `200`

Default Response

- object
  - `favoriteModels` object[], required
    - `agent` string, required
    - `model` string, required
    - `effort` string
    - `fastMode` boolean
    - `acpAgentId` string

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid bearer token.
- `404`: Resource not found.
- `default`: Error response.

---

[API](https://skmtc.dev/conductor-build/apis/roundhouse-public-api.md) - [All operations](https://skmtc.dev/conductor-build/apis/roundhouse-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductor-build/apis/roundhouse-public-api/revisions/1f39c7f7f219?raw)