---
title: "Set your account’s preferences"
method: POST
path: "/management-console/account/prefs"
tags: ["Your account"]
---

# Set your account’s preferences

`POST /management-console/account/prefs`

## Request

- Base URL: `https://verifiedhandles.org`
- URL: `https://verifiedhandles.org/management-console/account/prefs`
- Auth: HTTP bearer

Sets every preference on the account page at once, as its form does: a box left out is switched off. `PATCH /api/user/prefs` changes one at a time instead.

## Other responses

- `302`: Done: back to /management-console/account, `done=prefs`. (With no key and nobody signed in, a 302 to sign in instead.)
- `400`: The request sent a key and a session cookie together (`bearer_with_cookie`): send one.
- `401`: The key was refused: unknown, revoked or expired, its holder may no longer use keys, or this instance takes none. Carries `WWW-Authenticate: Bearer`.
- `403`: The key’s account lacks the capability, or is blocked: the body is the word `Forbidden`. A read-only key that tries to change something is refused first, as JSON: `{"error":"read_only_key"}`.
- `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)