Preferences API

Manage user-specific application preferences.

Endpoints Overview

Method	Endpoint	Description
GET	/preferences/me/preferences	Get my preferences
PATCH	/preferences/me/preferences	Update my preferences

---

Get Preferences

GET /preferences/me/preferences

Retrieve the current user's preferences (e.g., notifications, UI settings).

Response

{
  "user_id": "uuid-of-user",
  "email_notifications_enabled": true,
  "alert_email_frequency": "immediate",
  "min_alert_severity": "medium",
  "theme": "dark",
  "timezone": "Europe/Amsterdam",
  "show_copilot_debug": false
}

---

Update Preferences

PATCH /preferences/me/preferences

Update specific preference settings.

Request Body

{
  "theme": "light",
  "timezone": "America/New_York"
}

Preference Fields

Field	Type	Description
theme	string	light, dark, or the configured platform default
timezone	string | null	IANA time zone for date-time display and scheduling. null means use browser time zone.
email_notifications_enabled	boolean	Enable or disable email notifications
alert_email_frequency	string	Alert email cadence, such as immediate or daily
min_alert_severity	string	Minimum alert severity for notifications

Invalid time zones return 400 Bad Request.

Response

Returns the updated preference object.