fix api doc

reearth · Sep 17, 2024 · 073e0b5 · 073e0b5
1 parent b799d8c
commit 073e0b5
Showing 1 changed file with 13 additions and 3 deletions.
diff --git a/server/schemas/integration.yml b/server/schemas/integration.yml
@@ -55,10 +55,10 @@ paths:
       operationId: ModelFilter
       security:
         - bearerAuth: []
-      summary: Returns a models.
+      summary: Returns a list of models.
       tags:
         - Models
-      description: Returns a models.
+      description: Returns a list of models.
       responses:
         '200':
           description: A JSON array of user names
@@ -733,8 +733,10 @@ paths:
           description: Internal server error
     post:
       operationId: ItemCreateWithProject
+      summary: Create an Item.
       tags:
         - Items project
+      description: Create an Item.
       security:
         - bearerAuth: []
       requestBody:
@@ -836,7 +838,7 @@ paths:
       operationId: ItemGet
       security:
         - bearerAuth: []
-      summary: Returns an items.
+      summary: Returns an item.
       tags:
         - Items
       description: Returns an item.
@@ -927,6 +929,7 @@ paths:
       - $ref: '#/components/parameters/itemIdParam'
     get:
       operationId: ItemCommentList
+      summary: get an item comment
       tags:
         - Items comments
       security:
@@ -951,6 +954,7 @@ paths:
           description: Not found
     post:
       operationId: ItemCommentCreate
+      summary: create an item comment
       tags:
         - Items comments
       security:
@@ -1013,6 +1017,7 @@ paths:
           description: Not found
     delete:
       operationId: ItemCommentDelete
+      summary: delete item comment
       tags:
         - Items comments
       security:
@@ -1175,6 +1180,7 @@ paths:
       - $ref: '#/components/parameters/assetIdParam'
     get:
       operationId: AssetGet
+      summary: get asset
       tags:
         - Assets
       responses:
@@ -1192,6 +1198,7 @@ paths:
           description: Not found
     delete:
       operationId: AssetDelete
+      summary: delete asset
       tags:
         - Assets
       responses:
@@ -1216,6 +1223,7 @@ paths:
       - $ref: '#/components/parameters/assetIdParam'
     get:
       operationId: AssetCommentList
+      summary: get asset comments
       tags:
         - Assets comments
       security:
@@ -1240,6 +1248,7 @@ paths:
           description: Not found
     post:
       operationId: AssetCommentCreate
+      summary: create asset comments
       tags:
         - Assets comments
       security:
@@ -1302,6 +1311,7 @@ paths:
           description: Not found
     delete:
       operationId: AssetCommentDelete
+      summary: delete asset comments
       tags:
         - Assets comments
       security: