# “Preferences” Endpoints - POST Update the preferences for the current user

**URL:** <https://community.toggl.com/t/preferences-endpoints-post-update-the-preferences-for-the-current-user/176>\
**Category:** API References\
**Tags:** api, endpoints, parameters, preferences, post\
**Created:** [November 21, 2024, 12:41pm UTC](https://community.toggl.com/t/preferences-endpoints-post-update-the-preferences-for-the-current-user/176 "2024-11-21T12:41:04Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [November 21, 2024, 12:41pm UTC](https://community.toggl.com/t/preferences-endpoints-post-update-the-preferences-for-the-current-user/176/1 "2024-11-21T12:41:04Z")

</div>

```auto
https://api.track.toggl.com/api/v9/me/preferences

```

With this endpoint, preferences can be modified and alpha features can be enabled or disabled.

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new().basic_auth("<email>", "<password>"); let json = client.request(Method::POST, "https://api.track.toggl.com/api/v9/me/preferences".to_string()).json(&serde_json::json!(\{"activity_timeline_display_activity":"boolean","activity_timeline_grouping_interval":"string","activity_timeline_grouping_method":"string","activity_timeline_recording_level":"string","activity_timeline_sync_events":"boolean","alpha_features":[\{"alpha_feature_id":"integer","code":"string","deleted_at":"string","description":"string","enabled":"boolean"\}],"analyticsAdvancedFilters":"boolean","auto_tracker_delay_enabled":"boolean","auto_tracker_delay_in_seconds":"integer","automatic_tagging":"boolean","autotracking_enabled":"boolean","beginningOfWeek":"integer","calendar_snap_duration":"string","calendar_snap_initial_location":"string","calendar_visible_hours_end":"integer","calendar_visible_hours_start":"integer","calendar_zoom_level":"string","cell_swipe_actions_enabled":"boolean","charts_view_type":"string","collapseDetailedReportEntries":"boolean","collapseTimeEntries":"boolean","dashboards_view_type":"string","date_format":"string","decimal_separator":"string","default_project_id":"integer","default_task_id":"integer","displayDensity":"string","distinctRates":"string","duration_format":"string","duration_format_on_timer_duration_field":"boolean","edit_popup_integration_timer":"boolean","extension_send_error_reports":"boolean","extension_send_usage_statistics":"boolean","firstSeenBusinessPromo":"integer","focus_app_on_time_entry_started":"boolean","focus_app_on_time_entry_stopped":"boolean","haptic_feedback_enabled":"boolean","hide_keyboard_shortcut":"boolean","idle_detection_enabled":"boolean","idle_detection_interval_in_minutes":"integer","inactivity_behavior":"string","is_goals_view_expanded":"boolean","is_goals_view_shown":"boolean","is_summary_total_view_visible":"boolean","keep_mini_timer_on_top":"boolean","keep_window_on_top":"boolean","keyboard_increment_timer_page":"integer","keyboard_shortcuts_enabled":"boolean","keyboard_shortcuts_share_time_entries":"boolean","macos_auto_tracking_rules":[\{"id":"string","keyword":"string","project_id":"integer","task_id":"integer"\}],"macos_show_hide_toggl_keyboard_shortcut":\{"key":"integer","modifiers":"integer"\},"macos_stop_continue_keyboard_shortcut":\{"key":"integer","modifiers":"integer"\},"manualEntryMode":"string","manualMode":"boolean","manualModeOverlaySeen":"boolean","modify_on_start_time_change":"string","offlineMode":"string","pg_time_zone_name":"string","pomodoro_auto_start_break":"boolean","pomodoro_auto_start_focus":"boolean","pomodoro_break_interval_in_minutes":"integer","pomodoro_break_project_id":"integer","pomodoro_break_start_sound_enabled":"boolean","pomodoro_break_tag_id":"integer","pomodoro_countdown_timer":"boolean","pomodoro_enabled":"boolean","pomodoro_focus_interval_in_minutes":"integer","pomodoro_focus_sound":"string","pomodoro_global_sound_enabled":"boolean","pomodoro_interval_end_sound":"boolean","pomodoro_interval_end_volume":"integer","pomodoro_longer_break_duration_in_minutes":"integer","pomodoro_prevent_screen_lock":"boolean","pomodoro_rounds_before_longer_break":"integer","pomodoro_session_start_sound_enabled":"boolean","pomodoro_show_notifications":"boolean","pomodoro_stop_timer_at_interval_end":"boolean","pomodoro_track_breaks_as_time_entries":"boolean","projectDashboardActivityMode":"string","project_shortcut_enabled":"boolean","record_timeline":"boolean","remember_last_project":"string","reminder_days":"string","reminder_enabled":"boolean","reminder_interval_in_minutes":"integer","reminder_period":"string","reminder_snoozing_in_minutes":"integer","reportRounding":"boolean","reportRoundingDirection":"string","reportRoundingStepInMinutes":"integer","reportsHideWeekends":"boolean","run_app_on_startup":"boolean","running_entry_warning":"string","running_timer_notification_enabled":"boolean","seenFollowModal":"boolean","seenFooterPopup":"boolean","seenProjectDashboardOverlay":"boolean","seenTogglButtonModal":"boolean","send_daily_project_invites":"boolean","send_product_emails":"boolean","send_timer_notifications":"boolean","send_weekly_report":"boolean","sharing_shortcut_enabled":"boolean","showTimeInTitle":"boolean","show_all_entries":"boolean","show_changelog":"boolean","show_description_in_menu_bar":"boolean","show_dock_icon":"boolean","show_events_in_calendar":"boolean","show_project_in_menu_bar":"boolean","show_qr_scanner":"boolean","show_seconds_in_menu_bar":"boolean","show_timeline_in_day_view":"boolean","show_timer_in_menu_bar":"boolean","show_today_total_in_menu_bar":"boolean","show_total_billable_hours":"boolean","show_weekend_on_timer_page":"boolean","show_workouts_in_calendar":"boolean","sleep_behaviour":"string","smart_alerts_option":"string","snowballReportRounding":"string","stack_times_on_manual_mode_after":"string","start_automatically":"boolean","start_shortcut_mode":"string","stop_at_specific_time":"boolean","stop_automatically":"boolean","stop_entry_on_shutdown":"boolean","stop_specified_time":"string","stopped_timer_notification_enabled":"boolean","suggestions_enabled":"boolean","summaryReportAmounts":"string","summaryReportDistinctRates":"boolean","summaryReportGrouping":"string","summaryReportSortAsc":"boolean","summaryReportSortField":"string","summaryReportSubGrouping":"string","summary_total_mode":"string","tags_shortcut_enabled":"boolean","theme":"string","time_entry_display_mode":"string","time_entry_ghost_suggestions_enabled":"boolean","time_entry_invitations_notification_enabled":"boolean","time_entry_start_stop_input_mode":"string","timeofday_format":"string","timerView":"string","timerViewMobile":"string","toSAcceptNeeded":"boolean","use_mini_timer":"boolean","visibleFooter":"string","webTimeEntryStarted":"boolean","webTimeEntryStopped":"boolean","weeklyReportGrouping":"string","weeklyReportValueToShow":"string","windows_auto_tracking_rules":[\{"billable":"boolean","description":"string","enabled":"boolean","id":"string","parameters":\{"duration":"string","keyword":"string","keyword_mode":"string","time_of_day":"string","week_days":"string"\},"project_id":"integer","skip_when_timer_is_running":"boolean","start_without_confirmation":"boolean","tag_ids":[\{\}],"task_id":"integer","type":"integer"\}],"windows_show_hide_toggl_keyboard_shortcut":\{"key":"integer","modifiers":"integer"\},"windows_stop_continue_keyboard_shortcut":\{"key":"integer","modifiers":"integer"\},"windows_stop_start_keyboard_shortcut":\{"key":"integer","modifiers":"integer"\},"windows_theme":"string","workout_default_project_id":"integer","workout_default_tag_id":"integer"\})) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/api/preferences/#parameters-1)

#### Body[​](https://engineering.toggl.com/docs/api/preferences/#body)

| Name | Type | Description |
| --- | --- | --- |
| activity\_timeline\_display\_activity | boolean | - |
| activity\_timeline\_grouping\_interval | string | - |
| activity\_timeline\_grouping\_method | string | - |
| activity\_timeline\_recording\_level | string | - |
| activity\_timeline\_sync\_events | boolean | - |
| alpha\_features | Array of object | will be omitted if empty |
| analyticsAdvancedFilters | boolean | will be omitted if empty |
| auto\_tracker\_delay\_enabled | boolean | - |
| auto\_tracker\_delay\_in\_seconds | integer | - |
| automatic\_tagging | boolean | - |
| autotracking\_enabled | boolean | - |
| beginningOfWeek | integer | will be omitted if empty |
| calendar\_snap\_duration | string | - |
| calendar\_snap\_initial\_location | string | - |
| calendar\_visible\_hours\_end | integer | - |
| calendar\_visible\_hours\_start | integer | - |
| calendar\_zoom\_level | string | - |
| cell\_swipe\_actions\_enabled | boolean | - |
| charts\_view\_type | string | - |
| collapseDetailedReportEntries | boolean | will be omitted if empty |
| collapseTimeEntries | boolean | will be omitted if empty |
| dashboards\_view\_type | string | - |
| date\_format | string | - |
| decimal\_separator | string | will be omitted if empty |
| default\_project\_id | integer | - |
| default\_task\_id | integer | - |
| displayDensity | string | will be omitted if empty |
| distinctRates | string | will be omitted if empty |
| duration\_format | string | - |
| duration\_format\_on\_timer\_duration\_field | boolean | - |
| edit\_popup\_integration\_timer | boolean | - |
| extension\_send\_error\_reports | boolean | - |
| extension\_send\_usage\_statistics | boolean | - |
| firstSeenBusinessPromo | integer | will be omitted if empty |
| focus\_app\_on\_time\_entry\_started | boolean | - |
| focus\_app\_on\_time\_entry\_stopped | boolean | - |
| haptic\_feedback\_enabled | boolean | - |
| hide\_keyboard\_shortcut | boolean | will be omitted if empty |
| idle\_detection\_enabled | boolean | - |
| idle\_detection\_interval\_in\_minutes | integer | - |
| inactivity\_behavior | string | - |
| is\_goals\_view\_expanded | boolean | - |
| is\_goals\_view\_shown | boolean | - |
| is\_summary\_total\_view\_visible | boolean | - |
| keep\_mini\_timer\_on\_top | boolean | - |
| keep\_window\_on\_top | boolean | - |
| keyboard\_increment\_timer\_page | integer | - |
| keyboard\_shortcuts\_enabled | boolean | will be omitted if empty |
| keyboard\_shortcuts\_share\_time\_entries | boolean | - |
| macos\_auto\_tracking\_rules | Array of object | - |
| macos\_show\_hide\_toggl\_keyboard\_shortcut | object | - |
| macos\_stop\_continue\_keyboard\_shortcut | object | - |
| manualEntryMode | string | will be omitted if empty |
| manualMode | boolean | will be omitted if empty |
| manualModeOverlaySeen | boolean | will be omitted if empty |
| modify\_on\_start\_time\_change | string | - |
| offlineMode | string | will be omitted if empty |
| pg\_time\_zone\_name | string | - |
| pomodoro\_auto\_start\_break | boolean | - |
| pomodoro\_auto\_start\_focus | boolean | - |
| pomodoro\_break\_interval\_in\_minutes | integer | - |
| pomodoro\_break\_project\_id | integer | - |
| pomodoro\_break\_start\_sound\_enabled | boolean | - |
| pomodoro\_break\_tag\_id | integer | - |
| pomodoro\_countdown\_timer | boolean | - |
| pomodoro\_enabled | boolean | - |
| pomodoro\_focus\_interval\_in\_minutes | integer | - |
| pomodoro\_focus\_sound | string | - |
| pomodoro\_global\_sound\_enabled | boolean | - |
| pomodoro\_interval\_end\_sound | boolean | - |
| pomodoro\_interval\_end\_volume | integer | - |
| pomodoro\_longer\_break\_duration\_in\_minutes | integer | - |
| pomodoro\_prevent\_screen\_lock | boolean | - |
| pomodoro\_rounds\_before\_longer\_break | integer | - |
| pomodoro\_session\_start\_sound\_enabled | boolean | - |
| pomodoro\_show\_notifications | boolean | - |
| pomodoro\_stop\_timer\_at\_interval\_end | boolean | - |
| pomodoro\_track\_breaks\_as\_time\_entries | boolean | - |
| projectDashboardActivityMode | string | will be omitted if empty |
| project\_shortcut\_enabled | boolean | - |
| record\_timeline | boolean | - |
| remember\_last\_project | string | - |
| reminder\_days | string | - |
| reminder\_enabled | boolean | - |
| reminder\_interval\_in\_minutes | integer | - |
| reminder\_period | string | - |
| reminder\_snoozing\_in\_minutes | integer | - |
| reportRounding | boolean | will be omitted if empty |
| reportRoundingDirection | string | will be omitted if empty |
| reportRoundingStepInMinutes | integer | will be omitted if empty |
| reportsHideWeekends | boolean | will be omitted if empty |
| run\_app\_on\_startup | boolean | - |
| running\_entry\_warning | string | - |
| running\_timer\_notification\_enabled | boolean | - |
| seenFollowModal | boolean | will be omitted if empty |
| seenFooterPopup | boolean | will be omitted if empty |
| seenProjectDashboardOverlay | boolean | will be omitted if empty |
| seenTogglButtonModal | boolean | will be omitted if empty |
| send\_daily\_project\_invites | boolean | - |
| send\_product\_emails | boolean | - |
| send\_timer\_notifications | boolean | - |
| send\_weekly\_report | boolean | - |
| sharing\_shortcut\_enabled | boolean | - |
| showTimeInTitle | boolean | will be omitted if empty |
| show\_all\_entries | boolean | - |
| show\_changelog | boolean | - |
| show\_description\_in\_menu\_bar | boolean | - |
| show\_dock\_icon | boolean | - |
| show\_events\_in\_calendar | boolean | - |
| show\_project\_in\_menu\_bar | boolean | - |
| show\_qr\_scanner | boolean | - |
| show\_seconds\_in\_menu\_bar | boolean | - |
| show\_timeline\_in\_day\_view | boolean | will be omitted if empty |
| show\_timer\_in\_menu\_bar | boolean | - |
| show\_today\_total\_in\_menu\_bar | boolean | - |
| show\_total\_billable\_hours | boolean | will be omitted if empty |
| show\_weekend\_on\_timer\_page | boolean | will be omitted if empty |
| show\_workouts\_in\_calendar | boolean | - |
| sleep\_behaviour | string | - |
| smart\_alerts\_option | string | - |
| snowballReportRounding | string | will be omitted if empty |
| stack\_times\_on\_manual\_mode\_after | string | - |
| start\_automatically | boolean | - |
| start\_shortcut\_mode | string | - |
| stop\_at\_specific\_time | boolean | - |
| stop\_automatically | boolean | - |
| stop\_entry\_on\_shutdown | boolean | - |
| stop\_specified\_time | string | - |
| stopped\_timer\_notification\_enabled | boolean | - |
| suggestions\_enabled | boolean | - |
| summaryReportAmounts | string | will be omitted if empty |
| summaryReportDistinctRates | boolean | will be omitted if empty |
| summaryReportGrouping | string | will be omitted if empty |
| summaryReportSortAsc | boolean | will be omitted if empty |
| summaryReportSortField | string | will be omitted if empty |
| summaryReportSubGrouping | string | will be omitted if empty |
| summary\_total\_mode | string | - |
| tags\_shortcut\_enabled | boolean | - |
| theme | string | will be omitted if empty |
| time\_entry\_display\_mode | string | - |
| time\_entry\_ghost\_suggestions\_enabled | boolean | - |
| time\_entry\_invitations\_notification\_enabled | boolean | - |
| time\_entry\_start\_stop\_input\_mode | string | - |
| timeofday\_format | string | - |
| timerView | string | will be omitted if empty |
| timerViewMobile | string | will be omitted if empty |
| toSAcceptNeeded | boolean | ToSAcceptNeeded represents the trigger for new ToS accept dialog |
| use\_mini\_timer | boolean | - |
| visibleFooter | string | will be omitted if empty |
| webTimeEntryStarted | boolean | will be omitted if empty |
| webTimeEntryStopped | boolean | will be omitted if empty |
| weeklyReportGrouping | string | will be omitted if empty |
| weeklyReportValueToShow | string | will be omitted if empty |
| windows\_auto\_tracking\_rules | Array of object | - |
| windows\_show\_hide\_toggl\_keyboard\_shortcut | object | - |
| windows\_stop\_continue\_keyboard\_shortcut | object | - |
| windows\_stop\_start\_keyboard\_shortcut | object | - |
| windows\_theme | string | - |
| workout\_default\_project\_id | integer | - |
| workout\_default\_tag\_id | integer | - |

##### alpha\_features[​](https://engineering.toggl.com/docs/api/preferences/#alpha_features-1)

| Name | Type | Description |
| --- | --- | --- |
| alpha\_feature\_id | integer | Feature ID |
| code | string | Feature code |
| deleted\_at | string | Time of deletion, omitted if empty |
| description | string | Feature description, omitted if empty |
| enabled | boolean | Whether the feature is enabled |

##### macos\_auto\_tracking\_rules[​](https://engineering.toggl.com/docs/api/preferences/#macos_auto_tracking_rules-1)

| Name | Type | Description |
| --- | --- | --- |
| id | string | - |
| keyword | string | - |
| project\_id | integer | - |
| task\_id | integer | - |

##### macos\_show\_hide\_toggl\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#macos_show_hide_toggl_keyboard_shortcut-1)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### macos\_stop\_continue\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#macos_stop_continue_keyboard_shortcut-1)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_auto\_tracking\_rules[​](https://engineering.toggl.com/docs/api/preferences/#windows_auto_tracking_rules-1)

| Name | Type | Description |
| --- | --- | --- |
| billable | boolean | - |
| description | string | - |
| enabled | boolean | - |
| id | string | - |
| parameters | object | - |
| project\_id | integer | - |
| skip\_when\_timer\_is\_running | boolean | - |
| start\_without\_confirmation | boolean | - |
| tag\_ids | Array of integer | - |
| task\_id | integer | - |
| type | integer | - |

##### parameters[​](https://engineering.toggl.com/docs/api/preferences/#parameters-2)

| Name | Type | Description |
| --- | --- | --- |
| duration | string | - |
| keyword | string | - |
| keyword\_mode | string | - |
| time\_of\_day | string | - |
| week\_days | string | - |

##### windows\_show\_hide\_toggl\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_show_hide_toggl_keyboard_shortcut-1)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_stop\_continue\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_stop_continue_keyboard_shortcut-1)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

##### windows\_stop\_start\_keyboard\_shortcut[​](https://engineering.toggl.com/docs/api/preferences/#windows_stop_start_keyboard_shortcut-1)

| Name | Type | Description |
| --- | --- | --- |
| key | integer | - |
| modifiers | integer | - |

### Response[​](https://engineering.toggl.com/docs/api/preferences/#response-1)

#### 200[​](https://engineering.toggl.com/docs/api/preferences/#200-1)

Successful operation.

#### 400[​](https://engineering.toggl.com/docs/api/preferences/#400)

Possible error messages:

- Cannot set value for ToSAcceptNeeded
- Invalid feature code(s)
- Missing data
- Value in date\_format is invalid
- Value in timeofday\_format is invalid

#### 403[​](https://engineering.toggl.com/docs/api/preferences/#403-1)

User does not have access to this resource.

#### 500[​](https://engineering.toggl.com/docs/api/preferences/#500-1)

Internal Server Error