---
title: "Settings"
method: GET
path: "/api/settings"
---

# Settings

`GET /api/settings`

## Response `200`

Successful Response

- SettingsResponse
  - `harnesses` SettingsHarnessResponse[], required
    - `harness` string, required
    - `installed` boolean, required
    - `label` string, required
    - `logoKey` string, nullable
    - `managedLocation` string, nullable, required
    - `supportEnabled` boolean, required
  - `storage` SettingsStorageResponse, required
    - `configDir` string, required
    - `dataDir` string, required
    - `marketplaceCachePath` string, required
    - `platform` 'macos' | 'linux' | 'windows', required
    - `settingsPath` string, required
    - `skillsStorePath` string, required
    - `stateDir` string, required

## Changes

- **2026-07-30** `a2b29a5aa8b4` — 1 warning
  - added the new `windows` enum value to the `storage/platform` response property for the response status `200`
- **2026-07-30** `774e8a3f5f7e` — 1 info
  - removed the `windows` enum value from the `storage/platform` response property for the response status `200`
- **2026-07-29** `94bb53a09a42` — 1 warning
  - added the new `windows` enum value to the `storage/platform` response property for the response status `200`
- **2026-05-19** `2140f1cac483` — 2 info
  - added the required property `harnesses` to the response with the `200` status
  - added the required property `storage` to the response with the `200` status
- **2026-05-19** `73bfa4034c07` — 2 breaking
  - removed the required property `harnesses` from the response with the `200` status
  - removed the required property `storage` from the response with the `200` status

[Full history](https://skmtc.dev/mode-io/apis/skill-manager/changes/api/settings/get.md)

---

[API](https://skmtc.dev/mode-io/apis/skill-manager.md) · [All operations](https://skmtc.dev/mode-io/apis/skill-manager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mode-io/skill-manager/revisions/a2b29a5aa8b4/schema)