---
title: "Update Preferences"
method: PATCH
path: "/api/auth/preferences"
tags: ["Auth API"]
---

# Update Preferences

`PATCH /api/auth/preferences`

## Request

- Base URL: `https://api.top-posters.com`
- URL: `https://api.top-posters.com/api/auth/preferences`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/top-streaming/apis/top-posters-api/docs/api/auth/preferences/patch.ts> (a function with typed inputs; its response is checked against the schema)

Aggiornamento parziale; risponde con le impostazioni dopo la modifica.

## Request body

- PreferencesPatch
  - `enable_banners` boolean, nullable
  - `banner_rank_layout` 'classic' | 'window', nullable
  - `platform_original` PlatformOriginalPatch
    - `poster` boolean, nullable
    - `banner` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-13** `58f53e02c8af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/top-streaming/apis/top-posters-api/changes/api/auth/preferences/patch.md)

---

[API](https://skmtc.dev/top-streaming/apis/top-posters-api.md) - [All operations](https://skmtc.dev/top-streaming/apis/top-posters-api/llms.txt) - [OpenAPI document](https://skmtc.dev/top-streaming/apis/top-posters-api/revisions/58f53e02c8af?raw)