@lunch-money/developer-docs 2.11.1-preview.6 → 2.11.1-preview.8

package/docs/branding-your-app.md

@@ -1,22 +1,17 @@
 # Branding your App
 
-Building a tool, plugin, or integration on top of Lunch Money? Official brand assets and usage guidelines are available so you can credit Lunch Money clearly without reinventing logos or guessing at naming.
+Building a tool, plugin, or integration on top of Lunch Money? Use the official **Powered by Lunch Money** badge to credit the connection clearly — without implying that your app *is* Lunch Money.
 
-Everything lives in the <a href="https://lunchmoney.app/media-kit/" target="_blank" rel="noopener noreferrer">Lunch Money Media Kit</a>. Use that page as the source of truth for downloads, colors, typography, and the latest guidelines.
-
-## What you'll find in the media kit
-
-For developers, the most useful sections are:
-
-- **Logos** — horizontal, two-row, vertical, and emblem variants (PNG)
-- **Powered by** — a lockup and an embeddable badge for crediting Lunch Money in your app or README
-- **Colors & typography** — brand palette and typefaces (primary: Avenir; monospace: Inconsolata)
-- **Usage guidelines** — clear do's and don'ts for how marks may be used
-- **Product screenshots** — optional visuals if you're writing about or promoting an integration
+<a href="https://lunchmoney.app/assets/images/media-kit/powered-by-lunch-money-badge.png" download="powered-by-lunch-money-badge.png" target="_blank" rel="noopener noreferrer" title="Download Powered by Lunch Money badge">
+  <img src="/v2/images/powered-by-lunch-money-badge.png" alt="Powered by Lunch Money badge" />
+</a>
 
 > [!TIP]
-> Prefer the **Powered by** assets when your project connects to Lunch Money. They make the relationship clear without implying that your app *is* Lunch Money.
+> Click the badge to download it (or open the PNG in a new tab).
+>
+> Link it to <a href="https://lunchmoney.app/" target="_blank" rel="noopener noreferrer">lunchmoney.app</a> when you place it in a README, docs page, or app footer.
 
+For additional logos, colors, typography, screenshots, and full brand usage guidelines, see the <a href="https://lunchmoney.app/media-kit/" target="_blank" rel="noopener noreferrer">Lunch Money Media Kit</a>.
 ## Naming
 
 - Refer to the product as **Lunch Money**
@@ -30,7 +25,7 @@ Avoid nicknames, abbreviations, or stylized spellings of the product name in use
 ### Do
 
 - Use official logos without alteration
-- Use the provided **Powered by** lockup or badge when acknowledging Lunch Money
+- Use the **Powered by** badge when acknowledging Lunch Money
 - Keep enough clear space around logos so they stay readable
 - Download assets from the media kit rather than cropping screenshots of the logo
 
@@ -49,7 +44,7 @@ Avoid nicknames, abbreviations, or stylized spellings of the product name in use
 A few common, low-friction ways to brand an integration:
 
 1. **README or docs** — a short "Built with Lunch Money" line plus the Powered by badge linking to <a href="https://lunchmoney.app/" target="_blank" rel="noopener noreferrer">lunchmoney.app</a>
-2. **App footer or about screen** — the Powered by lockup next to your own branding
+2. **App footer or about screen** — the Powered by badge next to your own branding
 3. **Onboarding or connect flow** — official logo when prompting users to authorize or paste an access token
 4. **Community listings** — consistent naming ("My Tool for Lunch Money") so users can find and trust your project
 
@@ -57,7 +52,7 @@ Keep your own product name primary. Lunch Money branding should signal the conne
 
 ## Need help?
 
-If you're unsure whether a use is appropriate, or you need a format that isn't in the media kit:
+If you're unsure whether a use is appropriate, or you need a format that isn't listed here:
 
 - Start with the <a href="https://lunchmoney.app/media-kit/" target="_blank" rel="noopener noreferrer">Media Kit</a>
 - Ask in the <a href="https://lunchmoney.app/discord" target="_blank" rel="noopener noreferrer">Lunch Money Discord</a> **#developer-api** channel

package/docs/locales.md

@@ -0,0 +1,124 @@
+# Supported Locales
+
+Lunch Money uses locale tags to format numbers and currency amounts in the web
+and mobile apps. Date presentation is controlled separately by the user-level
+date-format settings. See
+[GET /me/user/settings](/v2/docs#tag/me/GET/me/user/settings) for those settings.
+Set the `locale` account setting to one of the supported tags below. The locale
+controls presentation details such as decimal separators, digit grouping, and
+currency symbol or code placement and rendering. It does not change the
+account's selected currency, numeric values, or the representation of dates,
+numbers, and amounts in API responses.
+
+## Locale Tag Format
+
+Each supported value combines a language code and a region code, separated by a
+hyphen. For example, `en-US` selects English formatting conventions for the
+United States, while `en-GB` selects English formatting conventions for the
+United Kingdom.
+
+## Supported Locales
+
+The examples format `123456789` as USD. An account's primary currency determines
+the currency symbol and number of fraction digits. Exact spacing and symbol
+rendering may vary slightly by platform and its internationalization
+implementation.
+
+| Tag | Language | Region | USD `123456789` example |
+|-----|----------|--------|-------------------------|
+| `sq-AL` | Albanian | Albania | `123 456 789,00 US$` |
+| `be-BY` | Belarusian | Belarus | `123 456 789,00 $` |
+| `bg-BG` | Bulgarian | Bulgaria | `123 456 789,00 щ.д.` |
+| `ca-ES` | Catalan | Spain | `123.456.789,00 USD` |
+| `zh-CN` | Chinese (Simplified) | China | `US$123,456,789.00` |
+| `zh-HK` | Chinese (Traditional) | Hong Kong | `US$123,456,789.00` |
+| `zh-TW` | Chinese (Traditional) | Taiwan | `US$123,456,789.00` |
+| `hr-HR` | Croatian | Croatia | `123.456.789,00 USD` |
+| `cs-CZ` | Czech | Czech Republic | `123 456 789,00 US$` |
+| `da-DK` | Danish | Denmark | `123.456.789,00 US$` |
+| `nl-BE` | Dutch | Belgium | `US$ 123.456.789,00` |
+| `nl-NL` | Dutch | Netherlands | `US$ 123.456.789,00` |
+| `en-AU` | English | Australia | `USD 123,456,789.00` |
+| `en-CA` | English | Canada | `US$123,456,789.00` |
+| `en-IN` | English | India | `$12,34,56,789.00` |
+| `en-IE` | English | Ireland | `US$123,456,789.00` |
+| `en-MT` | English | Malta | `US$123,456,789.00` |
+| `en-NZ` | English | New Zealand | `US$123,456,789.00` |
+| `en-PH` | English | Philippines | `$123,456,789.00` |
+| `en-SG` | English | Singapore | `US$123,456,789.00` |
+| `en-ZA` | English | South Africa | `US$123 456 789,00` |
+| `en-GB` | English | United Kingdom | `US$123,456,789.00` |
+| `en-US` | English | United States | `$123,456,789.00` |
+| `et-EE` | Estonian | Estonia | `123 456 789,00 $` |
+| `fi-FI` | Finnish | Finland | `123 456 789,00 $` |
+| `fr-BE` | French | Belgium | `123 456 789,00 $US` |
+| `fr-CA` | French | Canada | `123 456 789,00 $ US` |
+| `fr-FR` | French | France | `123 456 789,00 $US` |
+| `fr-LU` | French | Luxembourg | `123.456.789,00 $US` |
+| `fr-CH` | French | Switzerland | `123'456'789.00 $US` |
+| `de-AT` | German | Austria | `$ 123.456.789,00` |
+| `de-DE` | German | Germany | `123.456.789,00 $` |
+| `de-LU` | German | Luxembourg | `123.456.789,00 $` |
+| `de-CH` | German | Switzerland | `$ 123'456'789.00` |
+| `el-CY` | Greek | Cyprus | `123.456.789,00 $` |
+| `el-GR` | Greek | Greece | `123.456.789,00 $` |
+| `iw-IL` | Hebrew | Israel | `‏123,456,789.00 ‏$` |
+| `hi-IN` | Hindi | India | `$12,34,56,789.00` |
+| `hu-HU` | Hungarian | Hungary | `123 456 789,00 USD` |
+| `is-IS` | Icelandic | Iceland | `123.456.789,00 USD` |
+| `in-ID` | Indonesian | Indonesia | `US$123.456.789,00` |
+| `ga-IE` | Irish | Ireland | `$123,456,789.00` |
+| `it-IT` | Italian | Italy | `123.456.789,00 USD` |
+| `it-CH` | Italian | Switzerland | `USD 123'456'789.00` |
+| `ja-JP` | Japanese | Japan | `$123,456,789.00` |
+| `ko-KR` | Korean | South Korea | `US$123,456,789.00` |
+| `lv-LV` | Latvian | Latvia | `123 456 789,00 $` |
+| `lt-LT` | Lithuanian | Lithuania | `123 456 789,00 USD` |
+| `mk-MK` | Macedonian | Macedonia | `123.456.789,00 US$` |
+| `ms-MY` | Malay | Malaysia | `USD 123,456,789.00` |
+| `mt-MT` | Maltese | Malta | `US$123,456,789.00` |
+| `no-NO` | Norwegian | Norway | `123 456 789,00 USD` |
+| `pl-PL` | Polish | Poland | `123 456 789,00 USD` |
+| `pt-BR` | Portuguese | Brazil | `US$ 123.456.789,00` |
+| `pt-PT` | Portuguese | Portugal | `123 456 789,00 US$` |
+| `ro-RO` | Romanian | Romania | `123.456.789,00 USD` |
+| `ru-RU` | Russian | Russia | `123 456 789,00 $` |
+| `sk-SK` | Slovak | Slovakia | `123 456 789,00 USD` |
+| `sl-SI` | Slovenian | Slovenia | `123.456.789,00 $` |
+| `es-AR` | Spanish | Argentina | `US$ 123.456.789,00` |
+| `es-BO` | Spanish | Bolivia | `USD 123.456.789,00` |
+| `es-CL` | Spanish | Chile | `US$123.456.789,00` |
+| `es-CO` | Spanish | Colombia | `US$ 123.456.789,00` |
+| `es-CR` | Spanish | Costa Rica | `USD 123 456 789,00` |
+| `es-DO` | Spanish | Dominican Republic | `US$123,456,789.00` |
+| `es-EC` | Spanish | Ecuador | `$123.456.789,00` |
+| `es-SV` | Spanish | El Salvador | `$123,456,789.00` |
+| `es-GT` | Spanish | Guatemala | `USD 123,456,789.00` |
+| `es-HN` | Spanish | Honduras | `USD 123,456,789.00` |
+| `es-MX` | Spanish | Mexico | `USD 123,456,789.00` |
+| `es-NI` | Spanish | Nicaragua | `USD 123,456,789.00` |
+| `es-PA` | Spanish | Panama | `USD 123,456,789.00` |
+| `es-PY` | Spanish | Paraguay | `USD 123.456.789,00` |
+| `es-PE` | Spanish | Peru | `USD 123,456,789.00` |
+| `es-PR` | Spanish | Puerto Rico | `$123,456,789.00` |
+| `es-ES` | Spanish | Spain | `123.456.789,00 US$` |
+| `es-US` | Spanish | United States | `$123,456,789.00` |
+| `es-UY` | Spanish | Uruguay | `US$ 123.456.789,00` |
+| `es-VE` | Spanish | Venezuela | `USD 123.456.789,00` |
+| `sv-SE` | Swedish | Sweden | `123 456 789,00 US$` |
+| `th-TH` | Thai | Thailand | `US$123,456,789.00` |
+| `tr-TR` | Turkish | Turkey | `$123.456.789,00` |
+| `uk-UA` | Ukrainian | Ukraine | `123 456 789,00 USD` |
+| `vi-VN` | Vietnamese | Vietnam | `123.456.789,00 US$` |
+
+## Legacy Locale Tags
+
+The supported list retains two legacy language codes for compatibility:
+
+- Use `iw-IL` for Hebrew (Israel). The modern language code is `he`, but
+  `he-IL` is not currently accepted by the API.
+- Use `in-ID` for Indonesian (Indonesia). The modern language code is `id`, but
+  `id-ID` is not currently accepted by the API.
+
+Use the values listed in the table when reading or updating `locale` through the
+API.

package/manifest.json

@@ -41,6 +41,14 @@
       "type": "markdown",
       "aliases": ["/v2/currencies"]
     },
+    {
+      "path": "/locales",
+      "file": "docs/locales.md",
+      "title": "Supported Locales",
+      "section": "GUIDES",
+      "type": "markdown",
+      "aliases": ["/v2/locales"]
+    },
     {
       "path": "/amounts-and-balances",
       "file": "docs/amounts-and-balances.md",
@@ -199,6 +207,7 @@
         { "label": "Pagination", "path": "/pagination" },
         { "label": "Rate Limiting", "path": "/rate-limits" },
         { "label": "Supported Currencies", "path": "/currencies" },
+        { "label": "Supported Locales", "path": "/locales" },
         { "label": "Using the API with AI", "path": "/using-with-ai" },
         { "label": "Branding your App", "path": "/branding-your-app" }
       ]},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunch-money/developer-docs",
-  "version": "2.11.1-preview.6",
+  "version": "2.11.1-preview.8",
   "description": "Developer documentation content for Lunch Money APIs",
   "exports": {
     ".": "./package.json",

package/v2/docs/version-history.md

@@ -8,6 +8,10 @@ The Lunch Money API spec uses a modified version of SEMVER for its versioning me
 ## v2.11.1 - TBD
 - Add `GET /me/account/settings` and `PUT /me/account/settings` for account-level settings
 - Add `GET /me/user/settings` and `PUT /me/user/settings` for user-level display and formatting preferences
+- Add `GET /me/user/account/settings` and `PUT /me/user/account/settings` for settings specific to a user and budgeting account
+from `GET /me/account/settings` and `PUT /me/account/settings` to `GET /me/user/account/settings` and `PUT /me/user/account/settings`
+- Add `include_pending_in_totals` to `GET /me/account/settings` and `PUT /me/account/settings`
+- Add `default_manual_account_id` to `GET /me/user/account/settings` and `PUT /me/user/account/settings`
 - Document `GET /budgets/settings` response schema publicly; change `budget_period_quantity` to integer
 
 ## v2.11.0 - Jul 31, 2026

package/v2/spec/lunch-money-api-v2.yaml

@@ -6,36 +6,19 @@ info:
 
     Welcome to the Lunch Money v2 API reference. This is the **v2.11.1** spec.
 
-    > [!warning]
-    > **Preview endpoints (subject to change)**
-    >
-    > - [`GET /v2/me/account/settings`](#tag/me/GET/me/account/settings)
-    > - [`PUT /v2/me/account/settings`](#tag/me/PUT/me/account/settings)
-    > - [`GET /v2/me/user/settings`](#tag/me/GET/me/user/settings)
-    > - [`PUT /v2/me/user/settings`](#tag/me/PUT/me/user/settings)
-    >
-    > <p class="preview-endpoints-footer" style="margin:0.85em 0 0;padding:0;text-align:left;width:100%;box-sizing:border-box">Do not release production apps using these endpoints. Feedback is welcome. <a href="mailto:dev-support@lunchmoney.app">Email dev-support@lunchmoney.app</a> or join us in the <a href="https://discord.com/channels/842337014556262411/1134594318414389258">developers channel</a> on the <a href="https://lunchmoney.app/discord">Lunch Money Discord</a>.</p>
-
-    The most recent stable version of the API is v2.11.0 and is available at:
-    `https://api.lunchmoney.dev/v2`
-
-    See the [stable Developer Portal](https://lunchmoney.dev/v2).
-
-    ------------------------------------------------------------------------------------------------
-
-    The API is available at `https://api-beta.lunchmoney.app/v2`. Get your access token from the [Lunch Money developers page](https://my.lunchmoney.app/developers).
+    The API is available at `https://api.lunchmoney.dev/v2`. Get your access token from the [Lunch Money developers page](https://my.lunchmoney.app/developers).
 
     
     **Try it from these docs**
 
     These docs are interactive — use **Test request** on any endpoint to call the API from this page.
     Choose a LIVE or MOCK service from the Server dropdown.
-    Requests sent to `https://api-beta.lunchmoney.app/v2` can <span class="red-text"><strong>change or delete</strong></span> your data and are <span class="red-text"><strong>permanent</strong></span>.
-    See the [Getting Started Guide](https://beta.lunchmoney.dev/v2/getting-started) before using the live API.
+    Requests sent to `https://api.lunchmoney.dev/v2` can <span class="red-text"><strong>change or delete</strong></span> your data and are <span class="red-text"><strong>permanent</strong></span>.
+    See the [Getting Started Guide](https://lunchmoney.dev/v2/getting-started) before using the live API.
     
     **Static mock server**
 
-    Explore without risk to real data. Select `https://beta-mock.lunchmoney.dev/v2` in the Server dropdown to work with static mock data.
+    Explore without risk to real data. Select `http://mock.lunchmoney.dev/v2` in the Server dropdown to work with static mock data.
     POST, PUT, and DELETE requests will return realistic responses, but do not change the mock data.
     
 
@@ -45,14 +28,14 @@ info:
 
     **Migrating from v1**
 
-    The v2 API is not backwards compatible with v1. See the [Migration Guide](https://beta.lunchmoney.dev/v2/migration-guide) for details.
+    The v2 API is not backwards compatible with v1. See the [Migration Guide](https://lunchmoney.dev/v2/migration-guide) for details.
 
     **Useful links**
-    - [Getting Started Guide](https://beta.lunchmoney.dev/v2/getting-started)
-    - [v2 API Overview](https://beta.lunchmoney.dev/v2/overview)
-    - [Version History](https://beta.lunchmoney.dev/v2/version-history)
-    - [Migration Guide](https://beta.lunchmoney.dev/v2/migration-guide)
-    - [Rate Limits](https://beta.lunchmoney.dev/v2/rate-limits)
+    - [Getting Started Guide](https://lunchmoney.dev/v2/getting-started)
+    - [v2 API Overview](https://lunchmoney.dev/v2/overview)
+    - [Version History](https://lunchmoney.dev/v2/version-history)
+    - [Migration Guide](https://lunchmoney.dev/v2/migration-guide)
+    - [Rate Limits](https://lunchmoney.dev/v2/rate-limits)
   termsOfService: https://lunchmoney.dev/#current-status
   contact:
     email: devsupport@lunchmoney.app
@@ -62,17 +45,19 @@ info:
   version: 2.11.1
 
 servers:
-  - url: https://api-beta.lunchmoney.app/v2
+  - url: https://api.lunchmoney.dev/v2
     description: ⚠ LIVE — changes real Lunch Money data
-  - url: https://beta-mock.lunchmoney.dev/v2
+  - url: http://mock.lunchmoney.dev/v2
     description: MOCK — static demo data, no API key required
 
 tags:
   - name: me
     description: View details and settings for the current user and account.<p>
-      Use [/me/account/settings](#tag/me/GET/me/account/settings) and
-      [/me/user/settings](#tag/me/GET/me/user/settings) for account- and
-      user-level preferences.
+      Use [/me/user/settings](#tag/me/GET/me/user/settings) for user-wide
+      preferences, [/me/account/settings](#tag/me/GET/me/account/settings) for
+      account-wide preferences, and
+      [/me/user/account/settings](#tag/me/GET/me/user/account/settings) for
+      preferences specific to the current user and budgeting account.
   - name: categories
     description: Work with categories
     externalDocs:
@@ -3073,7 +3058,7 @@ components:
         currency:
           description: Three-letter lowercase currency code of the transaction
             in ISO 4217 format. Must match one of the [supported
-            currencies](https://beta.lunchmoney.dev/v2/currencies). If not set
+            currencies](https://lunchmoney.dev/v2/currencies). If not set
             defaults to the user account's primary currency.
           allOf:
             - $ref: "#/components/schemas/currencyEnum"
@@ -3815,6 +3800,7 @@ components:
         - budget_rollover_left_to_budget
 
     weekStartsOnEnum:
+      x-internal: true
       type: string
       title: week starts on enum
       enum:
@@ -3823,6 +3809,7 @@ components:
       description: The day on which a calendar week begins.
 
     monthYearFormatEnum:
+      x-internal: true
       type: string
       title: month and year format enum
       description: Format string for displaying month and year values
@@ -3849,6 +3836,7 @@ components:
         - "YYYY/MM"
 
     monthDayYearFormatEnum:
+      x-internal: true
       type: string
       title: month, day and year format enum
       description: Format string for displaying full dates in the
@@ -3906,6 +3894,7 @@ components:
         - "M/DD/YYYY"
 
     monthDayFormatEnum:
+      x-internal: true
       type: string
       title: month and day format enum
       description: Format string for displaying month and day values
@@ -3948,6 +3937,98 @@ components:
         - "DD.M"
         - "DD/M"
 
+    localeEnum:
+      type: string
+      title: locale enum
+      description: Locale used for formatting numbers and currency amounts in
+        the Lunch Money app.
+      example: en-US
+      enum:
+        - sq-AL # Albanian (Albania)
+        - be-BY # Belarusian (Belarus)
+        - bg-BG # Bulgarian (Bulgaria)
+        - ca-ES # Catalan (Spain)
+        - zh-CN # Chinese (Simplified) (China)
+        - zh-HK # Chinese (Traditional) (Hong Kong)
+        - zh-TW # Chinese (Traditional) (Taiwan)
+        - hr-HR # Croatian (Croatia)
+        - cs-CZ # Czech (Czech Republic)
+        - da-DK # Danish (Denmark)
+        - nl-BE # Dutch (Belgium)
+        - nl-NL # Dutch (Netherlands)
+        - en-AU # English (Australia)
+        - en-CA # English (Canada)
+        - en-IN # English (India)
+        - en-IE # English (Ireland)
+        - en-MT # English (Malta)
+        - en-NZ # English (New Zealand)
+        - en-PH # English (Philippines)
+        - en-SG # English (Singapore)
+        - en-ZA # English (South Africa)
+        - en-GB # English (United Kingdom)
+        - en-US # English (United States)
+        - et-EE # Estonian (Estonia)
+        - fi-FI # Finnish (Finland)
+        - fr-BE # French (Belgium)
+        - fr-CA # French (Canada)
+        - fr-FR # French (France)
+        - fr-LU # French (Luxembourg)
+        - fr-CH # French (Switzerland)
+        - de-AT # German (Austria)
+        - de-DE # German (Germany)
+        - de-LU # German (Luxembourg)
+        - de-CH # German (Switzerland)
+        - el-CY # Greek (Cyprus)
+        - el-GR # Greek (Greece)
+        - iw-IL # Hebrew (Israel); modern replacement: he-IL
+        - hi-IN # Hindi (India)
+        - hu-HU # Hungarian (Hungary)
+        - is-IS # Icelandic (Iceland)
+        - in-ID # Indonesian (Indonesia); modern replacement: id-ID
+        - ga-IE # Irish (Ireland)
+        - it-IT # Italian (Italy)
+        - it-CH # Italian (Switzerland)
+        - ja-JP # Japanese (Japan)
+        - ko-KR # Korean (South Korea)
+        - lv-LV # Latvian (Latvia)
+        - lt-LT # Lithuanian (Lithuania)
+        - mk-MK # Macedonian (Macedonia)
+        - ms-MY # Malay (Malaysia)
+        - mt-MT # Maltese (Malta)
+        - no-NO # Norwegian (Norway)
+        - pl-PL # Polish (Poland)
+        - pt-BR # Portuguese (Brazil)
+        - pt-PT # Portuguese (Portugal)
+        - ro-RO # Romanian (Romania)
+        - ru-RU # Russian (Russia)
+        - sk-SK # Slovak (Slovakia)
+        - sl-SI # Slovenian (Slovenia)
+        - es-AR # Spanish (Argentina)
+        - es-BO # Spanish (Bolivia)
+        - es-CL # Spanish (Chile)
+        - es-CO # Spanish (Colombia)
+        - es-CR # Spanish (Costa Rica)
+        - es-DO # Spanish (Dominican Republic)
+        - es-EC # Spanish (Ecuador)
+        - es-SV # Spanish (El Salvador)
+        - es-GT # Spanish (Guatemala)
+        - es-HN # Spanish (Honduras)
+        - es-MX # Spanish (Mexico)
+        - es-NI # Spanish (Nicaragua)
+        - es-PA # Spanish (Panama)
+        - es-PY # Spanish (Paraguay)
+        - es-PE # Spanish (Peru)
+        - es-PR # Spanish (Puerto Rico)
+        - es-ES # Spanish (Spain)
+        - es-US # Spanish (United States)
+        - es-UY # Spanish (Uruguay)
+        - es-VE # Spanish (Venezuela)
+        - sv-SE # Swedish (Sweden)
+        - th-TH # Thai (Thailand)
+        - tr-TR # Turkish (Turkey)
+        - uk-UA # Ukrainian (Ukraine)
+        - vi-VN # Vietnamese (Vietnam)
+
     accountSettingsObject:
       type: object
       title: account settings object
@@ -3971,13 +4052,19 @@ components:
           description: Display name of the budgeting account in the Lunch Money
             app.
         locale:
-          type: string
-          description: Locale used for formatting dates and numbers in the
-            Lunch Money app (for example, `en-US`). When no locale is explicitly
-            stored for the account, the effective locale is derived from the
-            `default_locale` associated with `primary_currency` in the
-            currencies table (for example, `usd` → `en-US`, `cad` → `en-CA`,
-            `gbp` → `en-GB`).
+          allOf:
+            - $ref: "#/components/schemas/localeEnum"
+          example: en-US
+          description: Locale used for formatting numbers and currency amounts
+            in the Lunch Money app (for example, `en-US`). See
+            [Supported Locales](https://lunchmoney.dev/v2/locales) for accepted
+            values. Date presentation is configured separately through
+            [GET /me/user/settings](#tag/me/GET/me/user/settings) and
+            [PUT /me/user/settings](#tag/me/PUT/me/user/settings). When no
+            locale is explicitly stored for the account, the effective locale
+            is derived from the `default_locale` associated with
+            `primary_currency` in the currencies table (for example, `usd` →
+            `en-US`, `cad` → `en-CA`, `gbp` → `en-GB`).
         auto_create_category_rules:
           type: boolean
           default: true
@@ -3988,16 +4075,11 @@ components:
           default: true
           description: If `true`, suggested transaction rules are created
             automatically.
-        auto_review_transaction_on_update:
-          type: boolean
-          default: true
-          description: If `true`, transactions are marked as reviewed when
-            updated.
-        auto_review_transaction_on_creation:
+        include_pending_in_totals:
           type: boolean
           default: true
-          description: If `true`, transactions are marked as reviewed when
-            created.
+          description: If `true`, pending transactions are included in account
+            totals.
       required:
         - primary_currency
         - supported_currencies
@@ -4005,13 +4087,13 @@ components:
         - locale
         - auto_create_category_rules
         - auto_create_suggested_transaction_rules
-        - auto_review_transaction_on_update
-        - auto_review_transaction_on_creation
+        - include_pending_in_totals
 
     updateAccountSettingsRequestObject:
       x-internal: true
       type: object
       additionalProperties: false
+      minProperties: 1
       description: Request body for updating account settings. Include at least
         one property to update.
       properties:
@@ -4033,9 +4115,15 @@ components:
           description: If set, updates the display name of the budgeting account.
           x-updatable: true
         locale:
-          type: string
-          description: If set, updates the locale used for formatting dates and
-            numbers in the Lunch Money app.
+          allOf:
+            - $ref: "#/components/schemas/localeEnum"
+          example: en-US
+          description: If set, updates the locale used for formatting numbers
+            and currency amounts in the Lunch Money app. See
+            [Supported Locales](https://lunchmoney.dev/v2/locales) for accepted
+            values. Date presentation is configured separately through
+            [GET /me/user/settings](#tag/me/GET/me/user/settings) and
+            [PUT /me/user/settings](#tag/me/PUT/me/user/settings).
           x-updatable: true
         auto_create_category_rules:
           type: boolean
@@ -4047,15 +4135,70 @@ components:
           description: If set, updates whether suggested transaction rules are
             created automatically.
           x-updatable: true
+        include_pending_in_totals:
+          type: boolean
+          description: If set, updates whether pending transactions are included
+            in account totals.
+          x-updatable: true
+
+    userAccountSettingsObject:
+      type: object
+      title: user account settings object
+      additionalProperties: false
+      description: Settings specific to the authorized user within the current
+        budgeting account.
+      properties:
+        auto_review_transaction_on_update:
+          type: boolean
+          default: true
+          description: If `true`, transactions are marked as reviewed when their
+            date, category, payee, amount, account, or notes are changed.
+        auto_review_transaction_on_creation:
+          type: boolean
+          default: true
+          description: If `true`, new manual transactions start as reviewed. If
+            `false`, they start as unreviewed.
+        default_manual_account_id:
+          type: integer
+          nullable: true
+          description: Manual account selected by default when the user creates a
+            manual transaction in the current budgeting account. Must identify a
+            manual account returned by
+            [GET /manual_accounts](#tag/manual_accounts/GET/manual_accounts) for
+            the current budgeting account. Set to `null` to clear the selection.
+      required:
+        - auto_review_transaction_on_update
+        - auto_review_transaction_on_creation
+        - default_manual_account_id
+
+    updateUserAccountSettingsRequestObject:
+      x-internal: true
+      type: object
+      additionalProperties: false
+      minProperties: 1
+      description: Request body for updating settings specific to the authorized
+        user within the current budgeting account. Include at least one property
+        to update.
+      properties:
         auto_review_transaction_on_update:
           type: boolean
           description: If set, updates whether transactions are marked as reviewed
-            when updated.
+            when their date, category, payee, amount, account, or notes are
+            changed.
           x-updatable: true
         auto_review_transaction_on_creation:
           type: boolean
-          description: If set, updates whether transactions are marked as reviewed
-            when created.
+          description: If set, updates whether new manual transactions start as
+            reviewed or unreviewed.
+          x-updatable: true
+        default_manual_account_id:
+          type: integer
+          nullable: true
+          description: If set, updates the manual account selected by default when
+            the user creates a manual transaction in the current budgeting
+            account. Must identify a manual account returned by
+            [GET /manual_accounts](#tag/manual_accounts/GET/manual_accounts) for
+            the current budgeting account. Set to `null` to clear the selection.
           x-updatable: true
 
     userSettingsObject:
@@ -4131,6 +4274,7 @@ components:
       x-internal: true
       type: object
       additionalProperties: false
+      minProperties: 1
       description: Request body for updating user settings. Include at least one
         property to update.
       properties:
@@ -4967,11 +5111,14 @@ paths:
       summary: Get current user
       description: |-
         Get details about the user associated with the supplied authorization
-        token.<p> For account- and user-level preferences, prefer
-        [/me/account/settings](#tag/me/GET/me/account/settings) and
-        [/me/user/settings](#tag/me/GET/me/user/settings). Properties such as
-        `primary_currency` and `budget_name` remain on this response for
-        backwards compatibility.
+        token.<p> Use [/me/user/settings](#tag/me/GET/me/user/settings) for
+        user-wide preferences,
+        [/me/account/settings](#tag/me/GET/me/account/settings) for account-wide
+        preferences, and
+        [/me/user/account/settings](#tag/me/GET/me/user/account/settings) for
+        preferences specific to the current user and budgeting account.
+        Properties such as `primary_currency` and `budget_name` remain on this
+        response for backwards compatibility.
       operationId: getMe
       parameters: []
       responses:
@@ -5000,13 +5147,9 @@ paths:
       tags:
         - me
       summary: Get account settings
-      description: |-
-        > [!warning]
-        > **Preview endpoint** — behavior is subject to change. This endpoint is available in the mock server but not implemented yet on the live api service. Design feedback is welcome. [Email dev-support@lunchmoney.app](mailto:dev-support@lunchmoney.app) or join us in the [developers channel](https://discord.com/channels/842337014556262411/1134594318414389258) on the [Lunch Money Discord](https://lunchmoney.app/discord).
-
-
-        Returns account-level settings for the budgeting account associated with the authorized API token.<p>
-        These settings apply only to this budgeting account; a user with access to multiple budgets has separate account settings for each.
+      description: >-
+        Returns settings for the current budgeting account. These settings apply
+        regardless of which user is accessing the account.
       operationId: getAccountSettings
       responses:
         "200":
@@ -5025,8 +5168,7 @@ paths:
                 locale: en-US
                 auto_create_category_rules: true
                 auto_create_suggested_transaction_rules: true
-                auto_review_transaction_on_update: true
-                auto_review_transaction_on_creation: true
+                include_pending_in_totals: true
         "401":
           $ref: "#/components/responses/unauthorizedToken"
         "429":
@@ -5038,18 +5180,11 @@ paths:
         - me
       summary: Update account settings
       description: |-
-        > [!warning]
-        > **Preview endpoint** — behavior is subject to change. This endpoint is available in the mock server but not implemented yet on the live api service. Design feedback is welcome. [Email dev-support@lunchmoney.app](mailto:dev-support@lunchmoney.app) or join us in the [developers channel](https://discord.com/channels/842337014556262411/1134594318414389258) on the [Lunch Money Discord](https://lunchmoney.app/discord).
-
-
         Updates account-level settings for the budgeting account
-        associated with the authorized API token.<p> 
-        These settings apply only to this budgeting account; a user with access to multiple budgets has separate account settings for each.<p>
-        You may submit the response from a
-        `GET /me/account/settings` as the request body; however, only certain
-        properties can be updated.<p> It is also possible to provide only the
-        properties to be updated in the request body, as long as the request
-        includes at least one updatable property.
+        associated with the authorized API token. Submit the full response from
+        `GET /me/account/settings` with one or more properties changed, or
+        provide only the properties to update. The request body must include at
+        least one property.
       operationId: updateAccountSettings
       requestBody:
         required: true
@@ -5064,7 +5199,7 @@ paths:
               Update automation preferences:
                 value:
                   auto_create_category_rules: false
-                  auto_review_transaction_on_creation: false
+                  include_pending_in_totals: false
       responses:
         "200":
           description: Account settings updated successfully
@@ -5089,13 +5224,10 @@ paths:
       tags:
         - me
       summary: Get user settings
-      description: |-
-        > [!warning]
-        > **Preview endpoint** — behavior is subject to change. This endpoint is available in the mock server but not implemented yet on the live api service. Design feedback is welcome. [Email dev-support@lunchmoney.app](mailto:dev-support@lunchmoney.app) or join us in the [developers channel](https://discord.com/channels/842337014556262411/1134594318414389258) on the [Lunch Money Discord](https://lunchmoney.app/discord).
-
-
-        Returns user-level display and formatting preferences for the user associated with the authorized API token.<p>
-        User settings belong to the user and apply across all budgets they can access.
+      description: >-
+        Returns display and formatting preferences for the authorized user.
+        These settings apply across every budgeting account the user owns or
+        collaborates on.
       operationId: getUserSettings
       responses:
         "200":
@@ -5125,18 +5257,11 @@ paths:
         - me
       summary: Update user settings
       description: |-
-        > [!warning]
-        > **Preview endpoint** — behavior is subject to change. This endpoint is available in the mock server but not implemented yet on the live api service. Design feedback is welcome. [Email dev-support@lunchmoney.app](mailto:dev-support@lunchmoney.app) or join us in the [developers channel](https://discord.com/channels/842337014556262411/1134594318414389258) on the [Lunch Money Discord](https://lunchmoney.app/discord).
-
-
         Updates user-level display and formatting preferences for the user
-        associated with the authorized API token.<p>
-        User settings belong to the user and apply across all budgets they can access.<p>
-        You may submit the response from a
-        from a `GET /me/user/settings` as the request body; however, only
-        certain properties can be updated.<p> It is also possible to provide
-        only the properties to be updated in the request body, as long as the
-        request includes at least one updatable property.<p> Updating
+        associated with the authorized API token. Submit the full response from
+        `GET /me/user/settings` with one or more properties changed, or provide
+        only the properties to update. The request body must include at least
+        one property.<p> Updating
         `show_debits_as_negative` affects display in the Lunch Money app only.
         Amount fields in API responses always use positive values for debits and
         negative values for credits.
@@ -5176,6 +5301,88 @@ paths:
           $ref: "#/components/responses/rateLimited"
         "500":
           $ref: "#/components/responses/serverError"
+  /me/user/account/settings:
+    get:
+      tags:
+        - me
+      summary: Get user account settings
+      description: >-
+        Returns settings specific to the authorized user within the current
+        budgeting account. These settings do not affect other users or the
+        authorized user's settings in other budgeting accounts.
+      operationId: getUserAccountSettings
+      responses:
+        "200":
+          description: Settings for the authorized user in the current budgeting
+            account
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/userAccountSettingsObject"
+              example:
+                auto_review_transaction_on_update: true
+                auto_review_transaction_on_creation: true
+                default_manual_account_id: null
+        "401":
+          $ref: "#/components/responses/unauthorizedToken"
+        "429":
+          $ref: "#/components/responses/rateLimited"
+        "500":
+          $ref: "#/components/responses/serverError"
+    put:
+      tags:
+        - me
+      summary: Update user account settings
+      description: |-
+        Updates settings specific to the authorized user within the current
+        budgeting account. Submit the full response from
+        `GET /me/user/account/settings` with one or more properties changed, or
+        provide only the properties to update. The request body must include at
+        least one property.
+      operationId: updateUserAccountSettings
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/updateUserAccountSettingsRequestObject"
+            examples:
+              Update review preference:
+                value:
+                  auto_review_transaction_on_creation: false
+              Clear default manual account:
+                value:
+                  default_manual_account_id: null
+      responses:
+        "200":
+          description: User account settings updated successfully
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/userAccountSettingsObject"
+              examples:
+                Update review preference:
+                  value:
+                    auto_review_transaction_on_update: true
+                    auto_review_transaction_on_creation: false
+                    default_manual_account_id: null
+                Clear default manual account:
+                  value:
+                    auto_review_transaction_on_update: true
+                    auto_review_transaction_on_creation: true
+                    default_manual_account_id: null
+        "400":
+          description: Invalid request body
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/errorResponseObject"
+        "401":
+          $ref: "#/components/responses/unauthorizedToken"
+        "429":
+          $ref: "#/components/responses/rateLimited"
+        "500":
+          $ref: "#/components/responses/serverError"
   /summary:
     get:
       tags:
@@ -9253,19 +9460,19 @@ paths:
           description: Sets the maximum number of transactions to return. If
             more match the filter criteria, the response will include a
             `has_more` attribute set to `true`. See
-            [Pagination](https://beta.lunchmoney.dev/v2/pagination)
+            [Pagination](https://lunchmoney.dev/v2/pagination)
         - name: offset
           in: query
           schema:
             type: integer
           description: Sets the offset for the records returned. This is
             typically set automatically in the header. See
-            [Pagination](https://beta.lunchmoney.dev/v2/pagination)
+            [Pagination](https://lunchmoney.dev/v2/pagination)
       responses:
         "200":
           description: Returns an array of transactions. <br><br>The `has_more`
             property is set to `true` if more transactions are available. See
-            [Pagination](https://beta.lunchmoney.dev/v2/pagination)
+            [Pagination](https://lunchmoney.dev/v2/pagination)
           content:
             application/json:
               schema: