---
title: "PUT /users/me/settings/"
method: PUT
path: "/users/me/settings/"
tags: ["users"]
---

# PUT /users/me/settings/

`PUT /users/me/settings/`

Replace the logged-in user's settings by new ones.

## Request body

- TournesolUserSettingsRequest — A representation of all user settings of the Tournesol project. This representation includes poll-agnostic settings in addition to the specific settings of each poll.
  - `general` GeneralUserSettingsRequest — The general user settings that are not related to Tournesol polls.
    - `notifications__lang` 'en' | 'fr' — * `en` - en * `fr` - fr
    - `notifications_email__research` boolean
    - `notifications_email__new_features` boolean
    - `home__intro_hidden` boolean
  - `videos` VideosPollUserSettingsRequest — The settings specific to the `videos` poll. Also inherit the settings common to each poll.
    - `comparison__auto_select_entities` boolean
    - `comparison__criteria_order` string[]
    - `comparison_ui__weekly_collective_goal_display` union
      - 'ALWAYS' | 'EMBEDDED_ONLY' | 'WEBSITE_ONLY' | 'NEVER' — * `ALWAYS` - always * `EMBEDDED_ONLY` - embedded_only * `WEBSITE_ONLY` - website_only * `NEVER` - never
      - ''
    - `comparison_ui__weekly_collective_goal_mobile` boolean
    - `rate_later__auto_remove` integer
    - `extension__search_reco` boolean — Whether Tournesol recommendations should be integrated in Youtube.com search results.
    - `extension__on_video_watched` union — What the browser extension should do when a video is detected as watched on YouTube. * `DO_NOTHING` - do_nothing * `MARK_AS_WATCHED` - mark_as_watched * `MARK_AS_WATCHED_AND_RATE_LATER` - mark_as_watched_and_rate_later
      - 'DO_NOTHING' | 'MARK_AS_WATCHED' | 'MARK_AS_WATCHED_AND_RATE_LATER' — * `DO_NOTHING` - do_nothing * `MARK_AS_WATCHED` - mark_as_watched * `MARK_AS_WATCHED_AND_RATE_LATER` - mark_as_watched_and_rate_later
      - ''
    - `recommendations__default_date` union
      - 'TODAY' | 'WEEK' | 'MONTH' | 'YEAR' | 'ALL_TIME' — * `TODAY` - today * `WEEK` - week * `MONTH` - month * `YEAR` - year * `ALL_TIME` - all_time
      - ''
    - `recommendations__default_languages` string[]
    - `recommendations__default_unsafe` boolean
    - `recommendations__default_exclude_compared_entities` boolean
    - `feed_foryou__date` union
      - 'TODAY' | 'WEEK' | 'MONTH' | 'YEAR' | 'ALL_TIME' — * `TODAY` - today * `WEEK` - week * `MONTH` - month * `YEAR` - year * `ALL_TIME` - all_time
      - ''
    - `feed_foryou__languages` string[]
    - `feed_foryou__unsafe` boolean
    - `feed_foryou__exclude_compared_entities` boolean
    - `feed_topitems__languages` string[]

## Response `200`

- TournesolUserSettings — A representation of all user settings of the Tournesol project. This representation includes poll-agnostic settings in addition to the specific settings of each poll.
  - `general` GeneralUserSettings — The general user settings that are not related to Tournesol polls.
    - `notifications__lang` 'en' | 'fr' — * `en` - en * `fr` - fr
    - `notifications_email__research` boolean
    - `notifications_email__new_features` boolean
    - `home__intro_hidden` boolean
  - `videos` VideosPollUserSettings — The settings specific to the `videos` poll. Also inherit the settings common to each poll.
    - `comparison__auto_select_entities` boolean
    - `comparison__criteria_order` string[]
    - `comparison_ui__weekly_collective_goal_display` union
      - 'ALWAYS' | 'EMBEDDED_ONLY' | 'WEBSITE_ONLY' | 'NEVER' — * `ALWAYS` - always * `EMBEDDED_ONLY` - embedded_only * `WEBSITE_ONLY` - website_only * `NEVER` - never
      - ''
    - `comparison_ui__weekly_collective_goal_mobile` boolean
    - `rate_later__auto_remove` integer
    - `extension__search_reco` boolean — Whether Tournesol recommendations should be integrated in Youtube.com search results.
    - `extension__on_video_watched` union — What the browser extension should do when a video is detected as watched on YouTube. * `DO_NOTHING` - do_nothing * `MARK_AS_WATCHED` - mark_as_watched * `MARK_AS_WATCHED_AND_RATE_LATER` - mark_as_watched_and_rate_later
      - 'DO_NOTHING' | 'MARK_AS_WATCHED' | 'MARK_AS_WATCHED_AND_RATE_LATER' — * `DO_NOTHING` - do_nothing * `MARK_AS_WATCHED` - mark_as_watched * `MARK_AS_WATCHED_AND_RATE_LATER` - mark_as_watched_and_rate_later
      - ''
    - `recommendations__default_date` union
      - 'TODAY' | 'WEEK' | 'MONTH' | 'YEAR' | 'ALL_TIME' — * `TODAY` - today * `WEEK` - week * `MONTH` - month * `YEAR` - year * `ALL_TIME` - all_time
      - ''
    - `recommendations__default_languages` string[]
    - `recommendations__default_unsafe` boolean
    - `recommendations__default_exclude_compared_entities` boolean
    - `feed_foryou__date` union
      - 'TODAY' | 'WEEK' | 'MONTH' | 'YEAR' | 'ALL_TIME' — * `TODAY` - today * `WEEK` - week * `MONTH` - month * `YEAR` - year * `ALL_TIME` - all_time
      - ''
    - `feed_foryou__languages` string[]
    - `feed_foryou__unsafe` boolean
    - `feed_foryou__exclude_compared_entities` boolean
    - `feed_topitems__languages` string[]

---

[API](https://skmtc.net/tournesol-app/apis/tournesol-api.md) · [All operations](https://skmtc.net/tournesol-app/apis/tournesol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tournesol-app/tournesol-api/revisions/96c8c62ad972/schema)