Skip navigation
REST › preferences.update

preferences.update

PATCH/preferences

Changes the default reading language or email choices; fields left out keep their value. Returns every choice after the change. Needs a key.

Parameters

ParameterInDescription
localebodyOptional. Default reading language: vi or en.
notifyPackUpdatesbodyOptional. true to get an email when a file pack or skill you bought or downloaded has a new version.
notifyBillingbodyOptional. true to get an email seven days before subscriber access ends.
notifyNewsletterbodyOptional. true to get the new-article newsletter. When it is turned on is recorded.
newsletterSourcebodyOptional. Page where the reader turned the newsletter on: welcome or profile. Agents usually leave it out.

Request

curl
curl -X PATCH "https://api.modernengineer.dev/preferences" \
  -H "Authorization: Bearer $SE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"notifyNewsletter":true}'

Response

200 OK · application/json
{
  "locale": "vi",
  "notifyPackUpdates": true,
  "notifyBilling": true,
  "notifyNewsletter": true
}

Errors

StatusErrorWhen
401unauthenticatedThe API key is missing or invalid. Comes with a WWW-Authenticate header.
400invalid_inputA field has the wrong type or value, for example a locale other than vi or en.

In MCP