---
title: "Update Appearance Settings"
method: PATCH
path: "/api/kiwi/settings/appearance"
tags: ["Kiwi Agent"]
---

# Update Appearance Settings

`PATCH /api/kiwi/settings/appearance`

## Request

- Base URL: `https://api.qomplement.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qomplement.com/api/kiwi/settings/appearance`
- Auth: HTTP bearer

Persist personal theme and display preferences so they follow the user across devices.

## Request body

- AppearancePreferenceRequest
  - `preference` 'system' | 'light' | 'dark', nullable
  - `appearance` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-09** `6fe617c112ef`: 1 info
  - endpoint added
- **2026-08-29** `7a7c8e2b5afc`: 1 breaking
  - api path removed without deprecation
- **2026-08-26** `c5a6fbe2731c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qomplement/apis/qomplement-api/changes/api/kiwi/settings/appearance/patch.md)

---

[API](https://skmtc.dev/qomplement/apis/qomplement-api.md) - [All operations](https://skmtc.dev/qomplement/apis/qomplement-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qomplement/apis/qomplement-api/revisions/6fe617c112ef?raw)