users

Update general settings for a user

Changed on Jun 1, 2026

Updates and returns general settings for a specific user. Requires MANAGE_USERS permission if editing other users.

post/user/{userId}/settings/main

Request

Base URL: http://localhost:5055/api/v1
URL: http://localhost:5055/api/v1/user/{userId}/settings/main
Auth: one of:
- API key in cookie connect.sid
- API key in header X-Api-Key

Path parameters

userIdnumber required

Request body

usernamestring nullable

emailstring

localestring nullable

discoverRegionstring nullable

streamingRegionstring nullable

originalLanguagestring nullable

movieQuotaLimitnumber nullable

Maximum number of movie requests allowed

movieQuotaDaysnumber nullable

Time period in days for movie quota

tvQuotaLimitnumber nullable

Maximum number of TV requests allowed

tvQuotaDaysnumber nullable

Time period in days for TV quota

globalMovieQuotaDaysnumber nullable

Global movie quota days setting

globalMovieQuotaLimitnumber nullable

Global movie quota limit setting

globalTvQuotaLimitnumber nullable

Global TV quota limit setting

globalTvQuotaDaysnumber nullable

Global TV quota days setting

watchlistSyncMoviesboolean nullable

Enable watchlist sync for movies

watchlistSyncTvboolean nullable

Enable watchlist sync for TV

Example request

{
  "username": "Mr User",
  "email": "user@example.com",
  "locale": "en",
  "discoverRegion": "US",
  "streamingRegion": "US",
  "originalLanguage": "en",
  "movieQuotaLimit": 10,
  "movieQuotaDays": 30,
  "tvQuotaLimit": 5,
  "tvQuotaDays": 14,
  "globalMovieQuotaDays": 30,
  "globalMovieQuotaLimit": 10,
  "globalTvQuotaLimit": 5,
  "globalTvQuotaDays": 14,
  "watchlistSyncMovies": true
}

Response

Updated user general settings returned