@lunch-money/developer-docs 2.11.1-preview.7 → 2.11.1-preview.9

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:
@@ -4955,9 +5099,58 @@ components:
     bearerSecurity:
       type: http
       description: >-
-        Required for the LIVE server. Optional for MOCK.
+        A Lunch Money personal access token. Required for the LIVE server and
+        optional for MOCK.
       scheme: bearer
       bearerFormat: JWT
+    oauth2Security:
+      type: oauth2
+      description: >-
+        An OAuth 2.0 access token issued to a registered Lunch Money app.
+        Each operation lists the scope required to call it.
+      flows:
+        authorizationCode:
+          authorizationUrl: https://api.lunchmoney.dev/oauth/authorize
+          tokenUrl: https://api.lunchmoney.dev/oauth/token
+          scopes:
+            offline_access: "Allow this app to maintain access without asking you to sign in and authorize it again"
+            me:read: "View your Lunch Money identity and account, user, and budget settings"
+            me:update: "Update your Lunch Money account, user, and budget settings"
+            summary:read: "View your budget summary"
+            categories:read: "View categories and category groups"
+            categories:create: "Create categories and category groups"
+            categories:update: "Update categories and category groups"
+            categories:delete: "Delete categories and category groups"
+            crypto_manual:read: "View supported cryptocurrencies and manually managed cryptocurrency balances"
+            crypto_manual:create: "Add supported cryptocurrencies and create manually managed cryptocurrency balances"
+            crypto_manual:update: "Update manually managed cryptocurrency balances"
+            crypto_manual:delete: "Delete manually managed cryptocurrency balances"
+            crypto_synced:read: "View synced cryptocurrency accounts and balances"
+            crypto_synced:update: "Refresh balances for synced cryptocurrency accounts"
+            balance_history:read: "View balance history for accounts and synced cryptocurrency balances"
+            balance_history:update: "Create or update balance history and details for deleted accounts"
+            balance_history:delete: "Delete balance history for accounts and synced cryptocurrency balances"
+            manual_accounts:read: "View manually managed accounts"
+            manual_accounts:create: "Create manually managed accounts"
+            manual_accounts:update: "Update manually managed accounts"
+            manual_accounts:delete: "Delete manually managed accounts"
+            plaid_accounts:read: "View accounts connected through Plaid"
+            plaid_accounts:update: "Request a Plaid account refresh, which may import new transactions"
+            transactions:read: "View transactions, including split and group information and attachment metadata"
+            transactions:create: "Create transactions"
+            transactions:update: "Update, split, unsplit, group, and ungroup transactions"
+            transactions:delete: "Delete transactions"
+            transaction_attachments:read: "Get download access to transaction attachments"
+            transaction_attachments:create: "Attach files to transactions"
+            transaction_attachments:delete: "Delete transaction attachments"
+            tags:read: "View tags"
+            tags:create: "Create tags"
+            tags:update: "Update tags"
+            tags:delete: "Delete tags"
+            recurring_items:read: "View recurring items"
+            budgets:read: "View budget period settings"
+            budgets:update: "Create or update budget amounts"
+            budgets:delete: "Delete budget amounts"
 
 paths:
   /me:
@@ -4967,12 +5160,19 @@ 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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:read
       parameters: []
       responses:
         "200":
@@ -5000,14 +5200,14 @@ 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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:read
       responses:
         "200":
           description: Account settings for the current budgeting account
@@ -5025,8 +5225,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,19 +5237,16 @@ 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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:update
       requestBody:
         required: true
         content:
@@ -5064,7 +5260,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,14 +5285,15 @@ 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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:read
       responses:
         "200":
           description: User settings for the authorized user
@@ -5125,22 +5322,19 @@ 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.
       operationId: updateUserSettings
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:update
       requestBody:
         required: true
         content:
@@ -5176,6 +5370,96 @@ 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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:read
+      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
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - me:update
+      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:
@@ -5187,6 +5471,10 @@ paths:
         budget objects.
       
       operationId: getBudgetSummary
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - summary:read
       parameters:
         - in: query
           name: start_date
@@ -5702,6 +5990,10 @@ paths:
       description: Retrieve a list of all categories associated with the user's
         account.
       operationId: getAllCategories
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - categories:read
       parameters:
         - name: format
           in: query
@@ -5949,6 +6241,10 @@ paths:
         this case, the `children` attribute may be set to an array of category
         IDs to add to the newly created category group.
       operationId: createCategory
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - categories:create
       requestBody:
         required: true
         content:
@@ -6054,6 +6350,10 @@ paths:
       description: Retrieve details of a specific category or category group by
         its ID.
       operationId: getCategoryById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - categories:read
       parameters:
         - name: id
           in: path
@@ -6192,6 +6492,10 @@ paths:
 
         It is possible to modify the children of an existing category group with this API by setting the `children` attribute. If this is set, it will replace the existing children with the newly specified children. If the intention is to add or remove a single category, it is more straightforward to update the child category by specifying the new `group_id` attribute. If the goal is to add multiple new children or remove multiple existing children, it is recommended to first call the `GET /categories/{id}` endpoint to get the existing children and then modify the list as desired.<br><br>
       operationId: updateCategory
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - categories:update
       parameters:
         - name: id
           in: path
@@ -6344,6 +6648,10 @@ paths:
         recurring items, etc. If there are dependents, this endpoint will return
         an object that describes the number and type of existing dependencies.
       operationId: deleteCategory
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - categories:delete
       parameters:
         - in: path
           name: id
@@ -6427,6 +6735,10 @@ paths:
         Retrieve the list of cryptocurrencies currently supported for manual tracking.<p>
         When creating a new manual crypto balance via `POST /crypto/manual`, the `symbol` you specify must match the `symbol` of one of the entries returned by this endpoint.
       operationId: getAllCryptocurrencies
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:read
       responses:
         "200":
           description: A list of supported cryptocurrencies
@@ -6463,6 +6775,10 @@ paths:
         - crypto-manual
       summary: Add a new supported cryptocurrency
       operationId: createCryptocurrency
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:create
       description: |-
         Adds a new cryptocurrency to the supported manual-crypto list.<br><br>
         Lunch Money uses [CoinGecko](https://www.coingecko.com/us/coins/ethereum) to convert crypto balances to the user's primary currency. Users add a new supported cryptocurrency by submitting a CoinGecko coin-page URL. The server validates the URL, extracts the id from `/coins/{id}`, checks for an existing supported `coingecko_id`, validates the id against CoinGecko, then confirms the resolved symbol is not already supported before creating the new entry.
@@ -6547,6 +6863,10 @@ paths:
       description: |-
         Retrieve all manually managed crypto balances associated with the user's account.
       operationId: getAllCryptoManual
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:read
       responses:
         "200":
           description: A list of manual crypto balances
@@ -6583,6 +6903,10 @@ paths:
         Create a manually managed crypto asset.<br><br>
         If `display_name` is `null`, clients may derive one from `institution_name` + `name`.
       operationId: createCryptoManual
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:create
       requestBody:
         required: true
         content:
@@ -6669,6 +6993,10 @@ paths:
       description: |-
         Retrieve a single manually managed crypto balance by ID.
       operationId: getCryptoManualById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:read
       parameters:
         - name: id
           in: path
@@ -6739,6 +7067,10 @@ paths:
         Modify a manually managed crypto balance.<br><br>
         You may submit the response from `GET /crypto/manual/{id}` as the request body. System-defined properties are accepted according to the `x-updatable` metadata in the update schema.
       operationId: updateCryptoManual
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:update
       parameters:
         - name: id
           in: path
@@ -6837,6 +7169,10 @@ paths:
       description: |-
         Delete a single manually managed crypto asset by ID.<p> If this crypto asset has a balance history, and you do not explicitly set the query parameter`keep_history`, a 422 response will be returned requesting you to explicitly set `keep_history` to `true` or `false`.
       operationId: deleteCryptoManual
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_manual:delete
       parameters:
         - name: id
           in: path
@@ -6903,6 +7239,10 @@ paths:
       description: |-
         Retrieves all synced crypto accounts associated with the user's account.
       operationId: getAllCryptoSynced
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_synced:read
       responses:
         "200":
           description: A list of synced crypto accounts
@@ -6966,6 +7306,10 @@ paths:
       description: |-
         Retrieves the synced crypto account and all nested balances for the specified synced crypto account ID.
       operationId: getCryptoSyncedById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_synced:read
       parameters:
         - name: id
           in: path
@@ -7047,6 +7391,10 @@ paths:
       description: |-
         Retrieves a single balance from the specified synced crypto account using the crypto symbol.
       operationId: getCryptoSyncedBalanceBySymbol
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_synced:read
       parameters:
         - name: id
           in: path
@@ -7127,6 +7475,10 @@ paths:
       description: |-
         Trigger a balance refresh for the specified synced crypto account. Returns the refreshed synced crypto account.
       operationId: refreshCryptoSynced
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - crypto_synced:update
       parameters:
         - name: id
           in: path
@@ -7207,6 +7559,10 @@ paths:
         &nbsp;&nbsp;&nbsp;&nbsp;- `crypto_manual`: `source.crypto_manual_id` with [GET /crypto/manual/{id}](#tag/crypto-manual/GET/crypto/manual/{id})<br>
         &nbsp;&nbsp;&nbsp;&nbsp;- `crypto_synced`: `source.crypto_synced_id` and `source.symbol` with [GET /crypto/synced/{id}/{symbol}](#tag/crypto-synced/GET/crypto/synced/{id}/{symbol})
       operationId: getBalanceHistory
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:read
       parameters:
         - name: start_month
           in: query
@@ -7462,6 +7818,10 @@ paths:
         The `account_type` path parameter identifies the account family (`manual`, `plaid`, `crypto_manual`, or `deleted`) and `account_id` identifies the account within that family.<br><br>
         `start_month`, `end_month`, and current-month entries behave as described in [GET /balance_history](#tag/balance-history/GET/balance_history).
       operationId: getBalanceHistoryForAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:read
       parameters:
         - name: account_type
           in: path
@@ -7598,6 +7958,10 @@ paths:
         `crypto_balance` may be provided for `crypto_manual` and `deleted` accounts. It is invalid for `manual` or `plaid` accounts.<br><br>
         The response contains only the `type: historical` balance entries that were submitted in this request.
       operationId: upsertBalanceHistoryForAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:update
       parameters:
         - name: account_type
           in: path
@@ -7794,6 +8158,10 @@ paths:
       description: |-
         Delete all historical balance entries for a single manual, Plaid, manual crypto, or deleted account. For synced crypto symbol streams, use [DELETE /balance_history/crypto_synced/{account_id}/{symbol}](#tag/balance-history/DELETE/balance_history/crypto_synced/{account_id}/{symbol}).
       operationId: deleteBalanceHistoryForAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:delete
       parameters:
         - name: account_type
           in: path
@@ -7840,6 +8208,10 @@ paths:
         The path selects one balance stream with a synced crypto account id and `symbol`.<br><br>
         `start_month`, `end_month`, and current-month entries behave as described in [GET /balance_history](#tag/balance-history/GET/balance_history).
       operationId: getBalanceHistoryForCryptoSynced
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:read
       parameters:
         - name: account_id
           in: path
@@ -7948,6 +8320,10 @@ paths:
         `crypto_balance` may be provided for synced crypto balances.<br><br>
         The response contains only the `type: historical` balance entries that were submitted in this request.
       operationId: upsertBalanceHistoryForCryptoSynced
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:update
       parameters:
         - name: account_id
           in: path
@@ -8092,6 +8468,10 @@ paths:
         Delete all historical balance entries for a single synced crypto symbol stream.<br><br>
         The path identifies both the synced crypto account and the symbol whose history should be deleted.
       operationId: deleteBalanceHistoryForCryptoSynced
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:delete
       parameters:
         - name: account_id
           in: path
@@ -8135,6 +8515,10 @@ paths:
       description: |-
         Delete a single stored (`type: historical`) monthly balance history entry by its id. Ephemeral `current` entries cannot be deleted this way.
       operationId: deleteBalanceHistoryEntry
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:delete
       parameters:
         - name: id
           in: path
@@ -8181,6 +8565,10 @@ paths:
         Update archived metadata for a deleted balance history source.<br><br>
         Pass the `deleted_account_id` from a `source.type: deleted` entry. The update applies to all historical entries associated with that deleted source.
       operationId: updateBalanceHistoryDetails
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - balance_history:update
       parameters:
         - name: account_id
           in: path
@@ -8252,6 +8640,10 @@ paths:
       description: Retrieve a list of all manually-managed accounts associated
         with the user's account.
       operationId: getAllManualAccounts
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - manual_accounts:read
       responses:
         "200":
           description: A list of manual accounts
@@ -8327,6 +8719,10 @@ paths:
       summary: Create a manual account
       description: Create a new manually-managed account.
       operationId: createManualAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - manual_accounts:create
       requestBody:
         required: true
         content:
@@ -8461,6 +8857,10 @@ paths:
       description: Retrieve the details of the manual account with the specified
         ID.
       operationId: getManualAccountById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - manual_accounts:read
       parameters:
         - name: id
           in: path
@@ -8545,6 +8945,10 @@ paths:
         properties that is not listed above. For example a request body that contains only a `name` property is valid.<br><br>
 
       operationId: updateManualAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - manual_accounts:update
       parameters:
         - name: id
           in: path
@@ -8688,6 +9092,10 @@ paths:
         property set to this account's ID they will appear with a warning when
         displayed in the web view.
       operationId: deleteManualAccount
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - manual_accounts:delete
       parameters:
         - in: path
           name: id
@@ -8747,6 +9155,10 @@ paths:
       description: Retrieve a list of all synced accounts associated with the
         user's account.
       operationId: getAllPlaidAccounts
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - plaid_accounts:read
       responses:
         "200":
           description: A list of accounts synced via Plaid
@@ -8853,6 +9265,10 @@ paths:
       description: Retrieve the details of the plaid account with the specified
         ID.
       operationId: getPlaidAccountById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - plaid_accounts:read
       parameters:
         - name: id
           in: path
@@ -8950,6 +9366,10 @@ paths:
         contacts the associated financial institution. The `last_import` field
         is updated only when new transactions have been imported.
       operationId: triggerPlaidAccountFetch
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - plaid_accounts:update
       parameters:
         - name: start_date
           in: query
@@ -9035,6 +9455,10 @@ paths:
         account. <br>If called with no parameters, this endpoint will return the
         most recent transactions, up to the specified `limit`.
       operationId: getAllTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:read
       parameters:
         - name: start_date
           in: query
@@ -9253,19 +9677,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:
@@ -9528,6 +9952,10 @@ paths:
         transactions that were duplicates of existing transactions and were not
         inserted.
       operationId: createNewTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:create
       requestBody:
         required: true
         content:
@@ -9968,6 +10396,10 @@ paths:
         
         The request can include between 1 and 500 transactions to update in a single call.
       operationId: updateTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       requestBody:
         required: true
         content:
@@ -10336,6 +10768,10 @@ paths:
         
         <span class="red-text"><strong>Use with caution. This action is not reversible!</strong></span>
       operationId: deleteTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:delete
       requestBody:
         required: true
         content:
@@ -10452,6 +10888,10 @@ paths:
         include the `children` property which will contain a list
         of the split transactions.
       operationId: getTransactionById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:read
       parameters:
         - name: id
           in: path
@@ -10695,6 +11135,10 @@ paths:
         an `category_id` attribute is valid.
         
       operationId: updateTransaction
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       parameters:
         - name: id
           in: path
@@ -10829,6 +11273,10 @@ paths:
 
         <span class="red-text"><strong>Use with caution. This action is not reversible!</strong></span>
       operationId: deleteTransactionById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:delete
       parameters:
         - in: path
           name: id
@@ -10902,6 +11350,10 @@ paths:
         be included in the `children` property of the transaction returned in
         the response
       operationId: groupTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       requestBody:
         required: true
         content:
@@ -11194,6 +11646,10 @@ paths:
         The transactions within the group are not removed and will subsequently
         be treated as "normal" ungrouped transactions.
       operationId: ungroupTransactions
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       parameters:
         - in: path
           name: id
@@ -11247,6 +11703,10 @@ paths:
         split, use the `GET /transactions/{id}` endpoint and pass the value of
         the `split_parent_id` of one of the children.
       operationId: splitTransaction
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       parameters:
         - name: id
           in: path
@@ -11448,6 +11908,10 @@ paths:
         Use the value of the `split_parent_id`property of a split transaction to
         specify the parent ID.
       operationId: unsplitTransaction
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transactions:update
       parameters:
         - in: path
           name: id
@@ -11489,6 +11953,10 @@ paths:
         - transactions (files)
       summary: Attach a file to a transaction
       operationId: attachFileToTransaction
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transaction_attachments:create
       description: |-
         Attaches a file to a transaction. The file must be less than 10MB in size.<br><br> The file will be attached to the transaction and can be downloaded from the link returned by a `GET /transactions/attachments/{file_id}` request.
       parameters:
@@ -11576,6 +12044,10 @@ paths:
       description: |-
         Returns a signed url that can be used to download the file attachment.
       operationId: getTransactionAttachmentUrl
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transaction_attachments:read
       tags:
         - transactions (files)
       parameters:
@@ -11629,6 +12101,10 @@ paths:
     delete:
       summary: Delete a file attachment
       operationId: deleteTransactionAttachment
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - transaction_attachments:delete
       description: >-
         Deletes a file attachment from a transaction.
       tags:
@@ -11674,6 +12150,10 @@ paths:
       description: Retrieve a list of all tags associated with the user's
         account.
       operationId: getAllTags
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - tags:read
       responses:
         "200":
           description: A list of tags
@@ -11744,6 +12224,10 @@ paths:
       summary: Create a new tag
       description: Creates a new tag with the given name
       operationId: createTag
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - tags:create
       requestBody:
         required: true
         content:
@@ -11811,6 +12295,10 @@ paths:
       summary: Get a single tag
       description: Retrieve the details of a specific tag with the specified ID.
       operationId: getTagById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - tags:read
       parameters:
         - name: id
           in: path
@@ -11890,6 +12378,10 @@ paths:
         properties that is not listed above. For example, a request body that contains only a
         `name` attribute is valid.
       operationId: updateTag
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - tags:update
       parameters:
         - name: id
           in: path
@@ -11993,6 +12485,10 @@ paths:
         returned and the tag is not deleted. This behavior can be overridden by
         setting the `force` parameter to `true`.
       operationId: deleteTag
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - tags:delete
       parameters:
         - in: path
           name: id
@@ -12056,6 +12552,10 @@ paths:
       summary: Get all recurring items
       description: Retrieve recurring items for a specified time frame.
       operationId: getAllRecurring
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - recurring_items:read
       parameters:
         - name: start_date
           in: query
@@ -12199,6 +12699,10 @@ paths:
       description: Retrieve the details of a specific recurring item with the
         specified ID.
       operationId: getRecurringById
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - recurring_items:read
       parameters:
         - name: id
           in: path
@@ -12315,6 +12819,10 @@ paths:
         budget preferences such as currency and locale, see
         [/me/account/settings](#tag/me/GET/me/account/settings).
       operationId: getBudgetSettings
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - budgets:read
       responses:
         "200":
           description: Budget period settings for the current budget
@@ -12343,6 +12851,10 @@ paths:
         Use the [/budgets/settings](#tag/budgets/GET/budgets/settings) endpoint to view the budget period settings for the account.<br>
         To view details for existing budgets, use the [summary](#tag/summary) endpoint.
       operationId: upsertBudget
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - budgets:update
       requestBody:
         required: true
         content:
@@ -12415,6 +12927,10 @@ paths:
         the account's budget settings.<br> To view details for existing budgets,
         use the [summary](#tag/summary) endpoint.
       operationId: deleteBudget
+      security:
+        - bearerSecurity: []
+        - oauth2Security:
+            - budgets:delete
       parameters:
         - in: query
           name: category_id