---
title: "Change your preferences"
method: PATCH
path: "/api/user/prefs"
tags: ["Your account"]
---

# Change your preferences

`PATCH /api/user/prefs`

## Request

- Base URL: `https://verifiedhandles.org`
- URL: `https://verifiedhandles.org/api/user/prefs`
- Auth: HTTP bearer

Changes the preferences sent, each on its own; the others stay as they are. The body may be at most 1 KiB.

## Request body

- PrefsChange: The preferences to change: at least one; the rest are left as they are.
  - `copyHandleOnly` boolean
  - `emailNotifications` boolean: Email me when something I sent is decided.
  - `nameVisibility` 'public' | 'trusted' | 'admins': Who sees my name on what I do: everyone, trusted editors and admins, or admins only.
  - `saveRecentSearches` boolean

## Response `200`

Changed.

- object
  - `ok` true, required

## Other responses

- `400`: The body is not JSON, names no preference, or gives one the wrong type. Or the request sent a key and a session cookie together (`bearer_with_cookie`): send one.
- `401`: No key was sent (`auth_required`), or the key was refused: unknown, revoked or expired, its holder may no longer use keys, or this instance takes none. Carries `WWW-Authenticate: Bearer`. After 60 refused keys from one IP address in a minute, every key from there is answered `429` (text, with `Retry-After`) until the minute is up.
- `403`: A read-only key tried to change something (`read_only_key`), or the account is blocked (`forbidden`).
- `413`: The body is over 1 KiB.
- `429`: Too many changes in the last minute: counted per IP address, per account and per key (an admin key’s per key alone, at the limit set on Console → Rate limits). Wait the number of seconds `Retry-After` gives.
- `503`: The site is down for maintenance. The body is the maintenance page, as HTML. Try again later: `Retry-After` gives the seconds.

---

[API](https://skmtc.dev/verifiedhandles/apis/verified-handles-api.md) · [All operations](https://skmtc.dev/verifiedhandles/apis/verified-handles-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verifiedhandles/apis/verified-handles-api/revisions/40720de2e0ec?raw)