kintone · shabaraba · Apr 3, 2025
diff --git a/kintone/20250101000000/components/schemas/AppsGetAppWithSpaceIdForm.yaml b/kintone/20250101000000/components/schemas/AppsGetAppWithSpaceIdForm.yaml
@@ -1,38 +1,65 @@
 ---
 properties:
   appId:
+    description: "The App ID\n"
     format: "long"
     type: "integer"
   code:
+    description: "The App Code of the App.\nAn empty string is returned if an App\
+      \ Code is not set in the App's settings.\n"
     type: "string"
   createdAt:
+    description: "The date of when the App was created.\n"
     format: "date-time"
     type: "string"
   creator:
+    description: "The information of the user who created the App.\n"
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   description:
+    description: "The description of the App.\nIf Localization settings are enabled,\
+      \ the localized name will be returned.\nThe localization language will be dependent\
+      \ on the language settings of the Kintone user authenticating this API.\n"
     type: "string"
   modifiedAt:
+    description: "The date of when the App was last modified.\n"
     format: "date-time"
     type: "string"
   modifier:
+    description: "The information of the user who last updated the App.\n"
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   name:
+    description: "The name of the App.\nIf Localization settings are enabled, the\
+      \ localized name will be returned.\nThe localization language will be dependent\
+      \ on the language settings of the Kintone user authenticating this API.\n"
     type: "string"
   spaceId:
+    description: "    If the App was created inside a Space,\n    it will return the\
+      \ Space ID. If not, null is returned.\n"
     format: "long"
     type: "integer"
   threadId:
+    description: "    If the App was created inside a Space,\n    it will return the\
+      \ Thread ID of the Thread of the space it belongs to.\n    Apps that are created\
+      \ inside Spaces using the GUI will be automatically allocated to the default\
+      \ Thread.\n    If the App was not created in a Space, null is returned.\n"
     format: "long"
     type: "integer"
 type: "object"

diff --git a/kintone/20250101000000/components/schemas/AppsStatisticsGetAppForm.yaml b/kintone/20250101000000/components/schemas/AppsStatisticsGetAppForm.yaml
@@ -8,8 +8,12 @@ properties:
   creator:
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   customized:
@@ -29,8 +33,12 @@ properties:
   modifier:
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   name:

diff --git a/kintone/20250101000000/components/schemas/BulkRequestPostRecordsPutOutputForm.yaml b/kintone/20250101000000/components/schemas/BulkRequestPostRecordsPutOutputForm.yaml
@@ -1,10 +1,12 @@
 ---
 properties:
   records:
-    items:
-      additionalProperties:
+    oneOf:
+    - type: "array"
+      items:
         $ref: "../../openapi.yaml#/components/schemas/BulkRequestPostRecordBean"
-      type: "object"
-    type: "array"
+    - type: "array"
+      items:
+        $ref: "../../openapi.yaml#/components/schemas/BulkRequestPostUpsertRecordBean"
 type: "object"
 
diff --git a/kintone/20250101000000/components/schemas/BulkRequestPostUpsertRecordBean.yaml b/kintone/20250101000000/components/schemas/BulkRequestPostUpsertRecordBean.yaml
@@ -0,0 +1,15 @@
+---
+properties:
+  id:
+    format: "long"
+    type: "integer"
+  operation:
+    enum:
+    - "INSERT"
+    - "UPDATE"
+    type: "string"
+  revision:
+    format: "long"
+    type: "integer"
+type: "object"
+
diff --git a/kintone/20250101000000/components/schemas/RecordCommentsGetCommentOutputForm.yaml b/kintone/20250101000000/components/schemas/RecordCommentsGetCommentOutputForm.yaml
@@ -6,8 +6,12 @@ properties:
   creator:
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   id:

diff --git a/kintone/20250101000000/components/schemas/RecordsPutUpsertRecordBean.yaml b/kintone/20250101000000/components/schemas/RecordsPutUpsertRecordBean.yaml
@@ -0,0 +1,15 @@
+---
+properties:
+  id:
+    format: "long"
+    type: "integer"
+  operation:
+    enum:
+    - "INSERT"
+    - "UPDATE"
+    type: "string"
+  revision:
+    format: "long"
+    type: "integer"
+type: "object"
+
diff --git a/kintone/20250101000000/components/schemas/SpaceGetAttachedApp.yaml b/kintone/20250101000000/components/schemas/SpaceGetAttachedApp.yaml
@@ -1,33 +1,54 @@
 ---
 properties:
   appId:
+    description: "The App ID\n"
     format: "long"
     type: "integer"
   code:
+    description: "The App Code of the App.\nAn empty string is returned if an App\
+      \ Code is not set in the App's settings.\n"
     type: "string"
   createdAt:
+    description: "The date of when the App was created.\n"
     format: "date-time"
     type: "string"
   creator:
+    description: "The information of the user who created the App.\n"
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   description:
+    description: "The description of the App.\nIf Localization settings are enabled,\
+      \ the localized name will be returned.\nThe localization language will be dependent\
+      \ on the language settings of the Kintone user authenticating this API.\n"
     type: "string"
   modifiedAt:
+    description: "The date of when the App was last modified.\n"
     format: "date-time"
     type: "string"
   modifier:
+    description: "The information of the user who last updated the App.\n"
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   name:
+    description: "The name of the App.\nIf Localization settings are enabled, the\
+      \ localized name will be returned.\nThe localization language will be dependent\
+      \ on the language settings of the Kintone user authenticating this API.\n"
     type: "string"
   threadId:
     format: "long"

diff --git a/kintone/20250101000000/components/schemas/SpacesStatisticsGetSpaceForm.yaml b/kintone/20250101000000/components/schemas/SpacesStatisticsGetSpaceForm.yaml
@@ -9,8 +9,12 @@ properties:
   creator:
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   id:
@@ -29,8 +33,12 @@ properties:
   modifier:
     properties:
       code:
+        description: "The log in name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
       name:
+        description: "The display name of the creator.\nAn empty string is returned\
+          \ for inactive users and deleted users.\n"
         type: "string"
     type: "object"
   name:

diff --git a/kintone/20250101000000/openapi.yaml b/kintone/20250101000000/openapi.yaml
@@ -2,17 +2,8 @@
 openapi: "3.1.0"
 info:
   title: "REST API SPEC"
-  version: "20250101000000"
-servers:
-  #  - url: https://sample.cybozu.com
-  - url: https://{domainId}.cybozu.com
-    variables:
-      domainId:
-        default: sample
-  - url: "{Custom URL}"
-    variables:
-      "Custom URL":
-        default: https://sample.cybozu.com
+  version: "1.0.0"
+servers: []
 paths:
   /k/guest/{guestSpaceId}/v1/app.json:
     $ref: "./paths/k_guest_v1_app.yaml"
@@ -578,6 +569,8 @@ components:
       $ref: "./components/schemas/BulkRequestPostTimeSimpleValue.yaml"
     BulkRequestPostUpdateKey:
       $ref: "./components/schemas/BulkRequestPostUpdateKey.yaml"
+    BulkRequestPostUpsertRecordBean:
+      $ref: "./components/schemas/BulkRequestPostUpsertRecordBean.yaml"
     BulkRequestPostUserEntitySimpleValue:
       $ref: "./components/schemas/BulkRequestPostUserEntitySimpleValue.yaml"
     BulkRequestPostUserSelectSimpleValue:
@@ -1604,6 +1597,8 @@ components:
       $ref: "./components/schemas/RecordsPutTimeSimpleValue.yaml"
     RecordsPutUpdateKey:
       $ref: "./components/schemas/RecordsPutUpdateKey.yaml"
+    RecordsPutUpsertRecordBean:
+      $ref: "./components/schemas/RecordsPutUpsertRecordBean.yaml"
     RecordsPutUserEntitySimpleValue:
       $ref: "./components/schemas/RecordsPutUserEntitySimpleValue.yaml"
     RecordsPutUserSelectSimpleValue:

diff --git a/kintone/20250101000000/paths/k_guest_v1_app.yaml b/kintone/20250101000000/paths/k_guest_v1_app.yaml
@@ -7,11 +7,15 @@ get:
     name: "guestSpaceId"
     required: true
     schema:
+      description: "guest space id"
+      title: "guestSpaceId"
       type: "integer"
-  - in: "query"
+  - description: "The App ID"
+    in: "query"
     name: "id"
     required: true
     schema:
+      description: "The App ID"
       format: "long"
       type: "integer"
   responses:
@@ -22,38 +26,68 @@ get:
           schema:
             properties:
               appId:
+                description: "The App ID\n"
                 format: "long"
                 type: "integer"
               code:
+                description: "The App Code of the App.\nAn empty string is returned\
+                  \ if an App Code is not set in the App's settings.\n"
                 type: "string"
               createdAt:
+                description: "The date of when the App was created.\n"
                 format: "date-time"
                 type: "string"
               creator:
+                description: "The information of the user who created the App.\n"
                 properties:
                   code:
+                    description: "The log in name of the creator.\nAn empty string\
+                      \ is returned for inactive users and deleted users.\n"
                     type: "string"
                   name:
+                    description: "The display name of the creator.\nAn empty string\
+                      \ is returned for inactive users and deleted users.\n"
                     type: "string"
                 type: "object"
               description:
+                description: "The description of the App.\nIf Localization settings\
+                  \ are enabled, the localized name will be returned.\nThe localization\
+                  \ language will be dependent on the language settings of the Kintone\
+                  \ user authenticating this API.\n"
                 type: "string"
               modifiedAt:
+                description: "The date of when the App was last modified.\n"
                 format: "date-time"
                 type: "string"
               modifier:
+                description: "The information of the user who last updated the App.\n"
                 properties:
                   code:
+                    description: "The log in name of the creator.\nAn empty string\
+                      \ is returned for inactive users and deleted users.\n"
                     type: "string"
                   name:
+                    description: "The display name of the creator.\nAn empty string\
+                      \ is returned for inactive users and deleted users.\n"
                     type: "string"
                 type: "object"
               name:
+                description: "The name of the App.\nIf Localization settings are enabled,\
+                  \ the localized name will be returned.\nThe localization language\
+                  \ will be dependent on the language settings of the Kintone user\
+                  \ authenticating this API.\n"
                 type: "string"
               spaceId:
+                description: "    If the App was created inside a Space,\n    it will\
+                  \ return the Space ID. If not, null is returned.\n"
                 format: "long"
                 type: "integer"
               threadId:
+                description: "    If the App was created inside a Space,\n    it will\
+                  \ return the Thread ID of the Thread of the space it belongs to.\n\
+                  \    Apps that are created inside Spaces using the GUI will be automatically\
+                  \ allocated to the default Thread.\n    If the App was not created\
+                  \ in a Space, null is returned.\n"
                 format: "long"
                 type: "integer"
             title: "getAppForGuestSpaceResponse"

diff --git a/kintone/20250101000000/paths/k_guest_v1_app_acl.yaml b/kintone/20250101000000/paths/k_guest_v1_app_acl.yaml
@@ -7,6 +7,8 @@ put:
     name: "guestSpaceId"
     required: true
     schema:
+      description: "guest space id"
+      title: "guestSpaceId"
       type: "integer"
   requestBody:
     required: true
@@ -51,6 +53,8 @@ get:
     name: "guestSpaceId"
     required: true
     schema:
+      description: "guest space id"
+      title: "guestSpaceId"
       type: "integer"
   - in: "query"
     name: "app"

diff --git a/kintone/20250101000000/paths/k_guest_v1_app_actions.yaml b/kintone/20250101000000/paths/k_guest_v1_app_actions.yaml
@@ -7,6 +7,8 @@ get:
     name: "guestSpaceId"
     required: true
     schema:
+      description: "guest space id"
+      title: "guestSpaceId"
       type: "integer"
   - in: "query"
     name: "app"

diff --git a/kintone/20250101000000/paths/k_guest_v1_app_adminnotes.yaml b/kintone/20250101000000/paths/k_guest_v1_app_adminnotes.yaml
@@ -7,6 +7,8 @@ get:
     name: "guestSpaceId"
     required: true
     schema:
+      description: "guest space id"
+      title: "guestSpaceId"
       type: "integer"
   - in: "query"
     name: "app"