@lunch-money/v2-api-spec 2.11.2-preview.10 → 2.11.2-preview.12

package/lunch-money-api-v2.yaml

@@ -400,7 +400,7 @@ components:
         children:
           type: array
           nullable: false
-          description: List of categories to include in the new category group. This field should only be set if `is_group` is also set to true.<br> You may provide existing category objects, existing category IDs, or names for new categories to add to the group. Categories or IDs must already exist and cannot be category groups. Categories that already belong to another group will be moved. If strings are provided, they will be used as names for new categories added to the group. The request will fail if any provided name already exists.<br> You may mix category objects, IDs, and new category names in the same request.
+          description: Categories to include in the new category group. Set only when `is_group` is `true`.<br> You may provide existing category objects, existing category IDs, or names for new categories. IDs and objects must refer to existing categories and cannot refer to category groups. Existing categories are added to the new group; categories that already belong to another group are moved. Each string is used as the name of a new category, and the request fails if that name already exists.<br> You may mix category objects, IDs, and new category names in the same request. Adding or moving an existing category updates it, so OAuth clients that include at least one existing category ID or object in `children` must have both `categories:create` and `categories:update`; without both scopes, the request returns a `403` `insufficient_scope` error. If every child is specified by name, `categories:create` alone is sufficient.
           items:
             oneOf:
               - type: integer
@@ -5456,12 +5456,15 @@ paths:
       tags:
         - categories
       summary: Create a new category or category group
-      description: Creates a new category with the given name.<br> If the `is_group` attribute is set to true, a category group is created. In this case, the `children` attribute may be set to an array of category IDs to add to the newly created category group.
+      description: Creates a new category with the given name.<br> If `is_group` is `true`, creates a category group; use `children` to add categories to it. OAuth clients that set `children` may also need `categories:update`; see the `children` property for the exact requirement.
       operationId: createCategory
       security:
         - bearerSecurity: []
         - oauth2Security:
             - categories:create
+        - oauth2Security:
+            - categories:create
+            - categories:update
       requestBody:
         required: true
         content:
@@ -5554,6 +5557,8 @@ paths:
                   - errMsg: Cannot specify a 'group_id' in request body if 'is_group' is also true
         "401":
           $ref: "#/components/responses/unauthorizedToken"
+        "403":
+          $ref: "#/components/responses/insufficientScope"
         "429":
           $ref: "#/components/responses/rateLimited"
         "500":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunch-money/v2-api-spec",
-  "version": "2.11.2-preview.10",
+  "version": "2.11.2-preview.12",
   "description": "OpenAPI specification and version history for the Lunch Money v2 API",
   "main": "lunch-money-api-v2.yaml",
   "exports": {