---
search:
  tags:
    - Account
    - PUT
seo:
  description: >-
    Changes the caller's app preferences on every platform at once; omitted
    fields are left… Reference for the PUT /api/settings endpoint in the skcal
    API.
sidebar:
  label: Update app settings
  badge: PUT
title: Update app settings
type: openapi-operation
---
Changes the caller's app preferences on every platform at once; omitted fields are left unchanged.

`PUT /api/settings`

**Request body** (`application/json`, required)

The settings to change.

- `mode` (string) — The app mode to switch to.
- `onboarded` (boolean) — True finishes or skips first-run onboarding.

Request body example:

```json
{
  "mode": "workout",
  "onboarded": true
}
```

**Responses**

- `200` — The settings after the change.
- `400` — The request body or parameters failed validation.

Response example, 200:

```json
{
  "mode": "workout",
  "onboarded": true
}
```
