---
title: "List model profiles"
method: GET
path: "/api/model-profiles"
tags: ["Models"]
---

# List model profiles

`GET /api/model-profiles`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/model-profiles`
- Auth: HTTP bearer

Every model profile, ordered by harness then name. Filter by `harness` to see what an agent on that harness can run.

## Query parameters

- `harness` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx'

## Response `200`

Model profiles

- object
  - `profiles` object[], required
    - `id` string, required
    - `name` string, required
    - `harness` 'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'dsh' | 'amp' | 'cursor' | 'grok' | 'fx', required
    - `model` string, required
    - `effort` 'off' | 'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'null', nullable, required
    - `allowCustomModel` boolean, required
    - `description` string, nullable, required
    - `seededFrom` string, nullable, required
    - `createdAt` string, required
    - `lastUpdatedAt` string, required

## Changes

- **2026-10-29** `305e33634408`: 1 warning, 1 info
  - added the new `fx` enum value to the `profiles/items/harness` response property for the response status `200`
  - added the new enum value `fx` to the `query` request parameter `harness`
- **2026-10-16** `cccec5621359`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/model-profiles/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)