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

# PATCH /users/me/settings/

`PATCH /users/me/settings/`

Update a subset of the logged-in user's settings.

## Request body

- PatchedTournesolUserSettingsRequest — 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
  - `videos` VideosPollUserSettingsRequest — The settings specific to the `videos` poll. Also inherit the settings common to each poll.
    - `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
      - ''
    - `rate_later__auto_remove` integer
    - `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

## 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
  - `videos` VideosPollUserSettings — The settings specific to the `videos` poll. Also inherit the settings common to each poll.
    - `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
      - ''
    - `rate_later__auto_remove` integer
    - `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

## Changes

- **2023-07-06** `5cc4be8f4e32` — 6 breaking, 2 warning, 8 info
  - removed the enum value `ENGLISH` of the request property `general/notifications__lang` (media type: application/json)
  - removed the enum value `ENGLISH` of the request property `general/notifications__lang` (media type: application/x-www-form-urlencoded)
  - removed the enum value `ENGLISH` of the request property `general/notifications__lang` (media type: multipart/form-data)
  - removed the enum value `FRENCH` of the request property `general/notifications__lang` (media type: application/json)
  - …12 more
- **2023-07-04** `b0f74d913a83` — 6 breaking, 46 warning, 8 info
  - removed the enum value `en` of the request property `general/notifications__lang` (media type: application/json)
  - removed the enum value `en` of the request property `general/notifications__lang` (media type: application/x-www-form-urlencoded)
  - removed the enum value `en` of the request property `general/notifications__lang` (media type: multipart/form-data)
  - removed the enum value `fr` of the request property `general/notifications__lang` (media type: application/json)
  - …56 more

[Change history](https://skmtc.dev/tournesol-app/apis/tournesol-api/changes/users/me/settings/patch.md)

---

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