---
title: "Update User Item Preferences"
method: PATCH
path: "/api/user-item-preferences"
tags: ["user-item-preferences"]
---

# Update User Item Preferences

`PATCH /api/user-item-preferences`

Update user cosmetic/display preferences in the user_item_preferences table.
Upserts on user_id so a row is created on first write.

## Headers

- `x-user-id` string, nullable

## Request body

- UpdateUserItemPreferencesRequest
  - `preferred_background` string, nullable
  - `preferred_hat` string, nullable
  - `preferred_bible_id` string, nullable
  - `preferred_symbol` string, nullable
  - `preferred_wing` string, nullable
  - `preferred_color` string, nullable
  - `preferred_shirt` string, nullable
  - `preferred_face` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usecreed/apis/creed-api.md) · [All operations](https://skmtc.net/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usecreed/creed-api/versions/523833f9e819/schema)