Users
Update preferences
Partially update the authenticated user's preferences.
PATCH /users/me/preferences
Partially updates the user's preferences. All fields are optional — only the fields you send are changed; everything else is left as-is. Returns the full, updated preferences object.
Authentication: Bearer token · Permission:
account:write · Rate limit: default (120 / 60s)Request body
All fields optional.
appearance
string
Theme preference. One of
auto, light, dark.notifications.email.billing
boolean
Receive billing-related emails.
notifications.email.productUpdates
boolean
Receive product-update emails.
notifications.email.promotional
boolean
Receive promotional emails.
{
"appearance": "dark",
"notifications": { "email": { "promotional": false } }
}
Request
curl -X PATCH https://api.twominutereports.com/v1/users/me/preferences \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "appearance": "dark", "notifications": { "email": { "promotional": false } } }'
Response
{
"success": true,
"data": {
"appearance": "dark",
"notifications": {
"email": { "billing": true, "productUpdates": true, "promotional": false }
}
}
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "appearance: Invalid enum value" }
}
{
"success": false,
"error": { "code": "UNAUTHORIZED", "message": "Authentication required" }
}