---
title: "Get the workspace intelligence levels"
method: GET
path: "/v1/model-settings"
tags: ["model-settings"]
---

# Get the workspace intelligence levels

`GET /v1/model-settings`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/model-settings`
- Auth: HTTP bearer

Show each intelligence level, the model and thinking setup it resolves to for this workspace, which level regular work uses, what each level is used for, and the models the workspace can build its own setup from.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- ModelSettingsResponse: The workspace's effective reasoning state, plus what it can choose from.
  - `tiers` ModelTierView[], required
    - `key` string, required
    - `label` string, required
    - `description` string, required
    - `used_for` string[], required
    - `model_id` string, required
    - `model_label` string, required
    - `reasoning` boolean, required
    - `thinking_label` string, required
    - `posture_label` string, required
    - `cost_label` string, required
    - `between_steps_label` string, required
    - `effort` string, nullable, required
    - `is_chat_default` boolean, required
    - `overridden` boolean, required
    - `fallback_model_id` string, nullable
    - `fallback_model_label` string, nullable
    - `fallback_effort` string, nullable
    - `fallback_posture_label` string, nullable
    - `fallback_note` string
  - `selected_tier` string, nullable, required
  - `using_recommended_routing` boolean, required
  - `using_recommended` boolean, required
  - `models` ModelChoice[], required
    - `id` string, required
    - `label` string, required
    - `description` string, required
    - `provider_label` string, required
    - `cost_label` string, required
    - `thinking_options` ThinkingOption[], required
      - `value` string, required
      - `label` string, required
      - `description` string, required
    - `recommended` boolean, required
    - `warning` string
  - `custom_tier` string, required
  - `custom_scope_note` string, required
  - `custom` CustomSetupView: The workspace's own model + thinking choice, when it has one.
    - `tier` string, required
    - `model_id` string, required
    - `model_label` string, required
    - `effort` string, nullable, required
    - `thinking_label` string, required
    - `posture_label` string, required
  - `model_choice_locked` boolean
  - `model_choice_locked_note` string, nullable

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

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