suggestgrid 0.1.27 → 0.1.30

data/spec/swagger.yaml

@@ -2,8 +2,8 @@ swagger: '2.0'
 
 info:
   title: SuggestGrid
-  version: 0.1.27
-  description: SuggestGrid is a recommendation and personalization service.
+  version: 0.1.30
+  description: Personalization made Simple
   x-codegen-settings:
     appendContentHeaders: true
     generateAsyncCode: true
@@ -43,8 +43,8 @@ tags:
   - name: type
     description: Type Methods
     x-docs-text: |
-      Type methods are used for managing SuggestGrid types.
-      For more information on types, refer to [Types concept documentation](http://www.suggestgrid.com/docs/types).
+      Type methods are used for creating, inspecting, and deleting SuggestGrid types.
+      [Types documentation](http://www.suggestgrid.com/docs/types) is available for an overview.
     x-methods:
       - create_type
       - get_type
@@ -54,8 +54,8 @@ tags:
   - name: action
     description: Action Methods
     x-docs-text: |
-      Action methods are for posting and deleting actions.
-      For more information on actions, refer to [Actions concept documentation](http://www.suggestgrid.com/docs/actions).
+      Action methods are for creating, inspecting, and deleting actions.
+      [Actions documentation](http://www.suggestgrid.com/docs/actions) is available for an overview.
     x-methods:
       - post_action
       - post_bulk_actions
@@ -64,8 +64,8 @@ tags:
   - name: metadata
     description: Metadata Methods
     x-docs-text: |
-      Metadata methods are for posting and deleting metadata.
-      For more information on metadata, refer to [Metadata concept documentation ](http://www.suggestgrid.com/docs/metadata).
+      Metadata methods are for creating, inspecting, and deleting metadata.
+      [Metadata documentation ](http://www.suggestgrid.com/docs/metadata) is available for an overview.
     x-methods:
       - post_user
       - post_bulk_users
@@ -82,16 +82,16 @@ tags:
   - name: recommendation
     description: Recommnedation Methods
     x-docs-text: |
-      Recommnedation methods are for getting recommended items or users responses from SuggestGrid.
-      For more information on recommendations, refer to [Recommendations concept documentation](http://www.suggestgrid.com/docs/recommendations).
+      Recommnedation methods are for getting recommended items, or recommended users from SuggestGrid.
+      [Recommendations documentation](http://www.suggestgrid.com/docs/recommendations) is available for an overview.
     x-methods:
       - get_recommended_users
       - get_recommended_items
   - name: similarity
     description: Similarity Methods
     x-docs-text: |
-      Similarity methods are for getting similar items or users responses from SuggestGrid.
-      For more information on similars, refer to [Similarities concept documentation](http://www.suggestgrid.com/docs/similarities).
+      Similarity methods are for getting similar items, or similar users from SuggestGrid.
+      [Similarities documentation](http://www.suggestgrid.com/docs/similarities) is available for an overview.
     x-methods:
       - get_similar_users
       - get_similar_items
@@ -100,8 +100,7 @@ definitions:
   Action:
     type: object
     description: |
-      An action object represents a user's action on an item.
-      All actions belong to a type that gives meaning to actions.
+      An action object represents a user's action of a type on an item.
     properties:
       type:
         type: string
@@ -115,6 +114,10 @@ definitions:
       rating:
         type: number
         description: The optional rating given by the user, if the type is explicit.
+      timestamp:
+        type: integer
+        format: int64
+        description: The optional UNIX epoch timestamp of the action. Defaults to the current timestamp.
     required:
       - type
       - user_id
@@ -132,13 +135,15 @@ definitions:
         - boolean
   Metadata:
     type: object
-    description: A metadata for a user or an item.
+    description: |
+      Metadata of a user or an item.
+      Id parameter is required for all metadata.
+      Metadata may have other parameters with string, number, or boolean values.
     properties:
       id:
         type: string
         description: |
-          The id of the user or the item that the metadata is associated with.
-          Id parameter is necessary for all metadata.
+          The id of the metadata of a user or an item.
     additionalProperties:
       type:
         - string
@@ -154,17 +159,14 @@ definitions:
     properties:
       rating:
         type: string
-        description:  |
-          The rating type of the type to be created.
-          Could be "explicit" or "implicit"
-          The default is "implicit".
+        description: The rating type of the type. Could be "explicit" or "implicit", where "implicit" is the default.
   GetRecommendedUsersBody:
     type: object
     description: Query for recommended users.
     properties:
       type:
         type: string
-        description: The type of the query.
+        description: The type of the query. Recommendations will be calculated based on actions of this type.
       types:
         type: string
         description: The types of the query. Exactly one of type or types parameters must be provided.
@@ -178,23 +180,25 @@ definitions:
           type: string
       from:
         type: integer
-        description: The number of most recommended items to be skipped.
+        description: The number of most recommended items to be skipped from the response. Defaults to 0.
       size:
         type: integer
-        description: The number of users asked to return in the response.
+        description: The number of users requested. Defaults to 10. Must be between 1 and 10,000 inclusive.
       similar_user_id:
         type: string
         description: Similar user that the response should be similar to.
       similar_user_ids:
-        type: string
+        type: array
         description: |
           Similar users that the response should be similar to.
           At most one of similar user and similar users parameters can be provided.
+        items:
+          type: string
       fields:
         type: array
         items:
           type: string
-        description: The metadata fields that are to be included in returned users.
+        description: The metadata fields to be included in returned user objects.
       filter:
         $ref: '#/definitions/Filter'
       except:
@@ -208,7 +212,7 @@ definitions:
     properties:
       type:
         type: string
-        description: The type of the query.
+        description: The type of the query. Recommendations will be calculated based on actions of this type.
       types:
         type: string
         description: The types of the query. Exactly one of type or types parameters must be provided.
@@ -222,23 +226,25 @@ definitions:
           type: string
       from:
         type: integer
-        description: The number of most recommended items to be skipped.
+        description: The number of most recommended items to be skipped from the response. Defaults to 0.
       size:
         type: integer
-        description: The number of items asked to return in the response.
+        description: The number of items requested. Defaults to 10. Must be between 1 and 10,000 inclusive.
       similar_item_id:
         type: string
         description: Similar item that the response should be similar to.
       similar_item_ids:
-        type: string
+        type: array
         description: |
           Similar items that the response should be similar to.
           At most one of similar item and similar items parameters can be provided.
+        items:
+          type: string
       fields:
         type: array
         items:
           type: string
-        description: The metadata fields that are to be included in returned items.
+        description: The metadata fields to be included in returned item objects.
       filter:
         $ref: '#/definitions/Filter'
       except:
@@ -248,11 +254,11 @@ definitions:
         description: These item ids that will not be included in the response.
   GetSimilarUsersBody:
     type: object
-    description: The query for similar users.
+    description: Query for similar users.
     properties:
       type:
         type: string
-        description: The type of the query.
+        description: The type of the query. Similarities will be calculated based on actions of this type.
       types:
         type: string
         description: The types of the query. Exactly one of type or types parameters must be provided.
@@ -266,15 +272,15 @@ definitions:
           type: string
       from:
         type: integer
-        description: The number of most similar users to be skipped.
+        description: The number of most similar users to be skipped from the response. Defaults to 0.
       size:
         type: integer
-        description: The number of users asked to return in the response.
+        description: The number of users requested. Defaults to 10. Must be between 1 and 10,000 inclusive.
       fields:
         type: array
         items:
           type: string
-        description: The metadata fields that are to be included in returned users.
+        description: The metadata fields to be included in returned user objects.
       filter:
         $ref: '#/definitions/Filter'
       except:
@@ -284,11 +290,11 @@ definitions:
         description: These user ids that will not be included in the response.
   GetSimilarItemsBody:
     type: object
-    description: The query for similar items.
+    description: Query for similar items.
     properties:
       type:
         type: string
-        description: The type of the query.
+        description: The type of the query. Similarities will be calculated based on actions of this type.
       types:
         type: string
         description: The types of the query. Exactly one of type or types parameters must be provided.
@@ -304,15 +310,15 @@ definitions:
           type: string
       from:
         type: integer
-        description: The number of most similar items to be skipped.
+        description: The number of most similar items to be skipped from the response. Defaults to 0.
       size:
         type: integer
-        description: The number of items asked to return in the response.
+        description: The number of items requested. Defaults to 10. Must be between 1 and 10,000 inclusive.
       fields:
         type: array
         items:
           type: string
-        description: The metadata fields that are to be included in returned items.
+        description: The metadata fields to be included in returned item objects.
       filter:
         $ref: '#/definitions/Filter'
       except:
@@ -356,7 +362,7 @@ definitions:
         description: Description of the response.
       error_uri:
         type: string
-        description: URI of the response for more details.
+        description: The URI of the error for more details.
   DetailedErrorResponse:
     type: object
     description: Error response.
@@ -369,7 +375,7 @@ definitions:
         description: Description of the response.
       error_uri:
         type: string
-        description: URI of the response for more details.
+        description: The URI of the error for more details.
       error_details:
         type: string
         description: Specific details of the response.
@@ -385,14 +391,14 @@ definitions:
         description: Description of the response.
       error_uri:
         type: string
-        description: URI of the response for more details.
+        description: The URI of the error for more details.
       used:
         type: integer
-        format: int32
+        format: int64
         description: The quantity used by the account.
       limit:
         type: integer
-        format: int32
+        format: int64
         description: The limit quantity of the account.
   DeleteErrorResponse:
     type: object
@@ -406,19 +412,19 @@ definitions:
         description: Description of the response.
       error_uri:
         type: string
-        description: URI of the response for more details.
+        description: The URI of the error for more details.
       found:
         type: integer
-        format: int32
-        description: The number of records found for the delete query.
+        format: int64
+        description: The number of records found.
       deleted:
         type: integer
-        format: int32
-        description: The number of records deleted for the delete query.
+        format: int64
+        description: The number of records deleted.
       failed:
         type: integer
-        format: int32
-        description: The number of records found but not deleted for the delete query.
+        format: int64
+        description: The number of records failed to be deleted.
   DeleteSuccessResponse:
     type: object
     description: Successful delete response with found, deleted, and failed parameters.
@@ -428,16 +434,16 @@ definitions:
         description: Message of the response.
       found:
         type: integer
-        format: int32
-        description: The number of records found for the delete query.
+        format: int64
+        description: The number of records found.
       deleted:
         type: integer
-        format: int32
-        description: The number of records deleted for the delete query.
+        format: int64
+        description: The number of records deleted.
       failed:
         type: integer
-        format: int32
-        description: The number of records found but not deleted for the delete query.
+        format: int64
+        description: The number of records failed to be deleted.
   GetTypesResponse:
     type: object
     description: Type names response.
@@ -447,10 +453,6 @@ definitions:
         description: The list of type names
         items:
           type: string
-      status:
-        type: integer
-        format: int32
-        description: Status code of the response. It is not 2XX.
   GetTypeResponse:
     type: object
     description: Get type details response.
@@ -531,10 +533,6 @@ paths:
           description: Get types response.
           schema:
             $ref: '#/definitions/GetTypesResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -549,11 +547,7 @@ paths:
         200:
           description: Get types response.
           schema:
-            $ref: '#/definitions/GetTypesResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
+            $ref: '#/definitions/MessageResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -577,8 +571,8 @@ paths:
           description: Get type response.
           schema:
             $ref: '#/definitions/GetTypeResponse'
-        429:
-          description: Too many requests.
+        404:
+          description: Type does not exists.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -594,7 +588,7 @@ paths:
       parameters:
         - name: type
           in: path
-          description: The name of the type to be created.
+          description: The name of the type.
           required: true
           type: string
           format: id
@@ -621,10 +615,6 @@ paths:
           description: Rating type is not `implicit` or `explicit`.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -635,8 +625,7 @@ paths:
       operationId: delete_type
       summary: Delete a Type
       description: |
-        Deletes a type with ALL of its actions and recommendation model.
-        Do not use this if you will need the type.
+        Warning: Deletes the type with all of its actions and its recommendation model.
       parameters:
         - name: type
           in: path
@@ -650,11 +639,7 @@ paths:
           schema:
             $ref: '#/definitions/MessageResponse'
         404:
-          description: Type does not exists.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+          description: Action type does not exists.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -685,7 +670,7 @@ paths:
           schema:
             $ref: '#/definitions/MessageResponse'
         400:
-          description: Required `user_id` or `item_id` parameters are missing from the request body.
+          description: Required user id or item id parameters are missing from the request.
           schema:
             $ref: '#/definitions/ErrorResponse'
         402:
@@ -693,11 +678,7 @@ paths:
           schema:
             $ref: '#/definitions/ErrorResponse'
         404:
-          description: Type does not exists.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+          description: Action type does not exists.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -712,6 +693,7 @@ paths:
       description: |
         Get actions. Defaut responses will be paged by 10 actios each.
         Type, user id, item id, or older than parameters could be provided.
+        The intersection of the provided parameters will be returned.
       parameters:
         - name: type
           in: query
@@ -735,37 +717,32 @@ paths:
           in: query
           description: |
             Maxium timestamp of the actions.
-            Valid times are 1s, 1m, 1h, 1d, 1M, 1y, or unix timestamp (like 1443798195).
+            Valid times are in form of 1s, 1m, 1h, 1d, 1M, 1y, where 1 can be any integer, or a UNIX timestamp like 1443798195.
           required: false
           type: string
-          format: id
         - name: size
           in: query
           description: |
             The number of the users response.
-            Defaults to 10. Must be between 1 and 10.000 inclusive.
+            Defaults to 10. Must be between 1 and 10,000 inclusive.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
         - name: from
           in: query
           description: |
-            The number of users to be skipped for response.
+            The number of users to be skipped from the response.
             Defaults to 0. Must be bigger than or equal to 0.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
       responses:
         200:
           description: Paged actions response.
           schema:
             $ref: '#/definitions/ActionsResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -776,14 +753,14 @@ paths:
       operationId: delete_actions
       summary: Delete Actions
       description: |
-        Type must be provided. Additionally,
-
-        * If both user id and item id are supplied the user's actions on the item will be deleted.
-        * If only user id is provided, all actions of the user will be deleted.
-        * If only item id is provided, all actions on the item will be deleted.
-        * If only older than is provided, all actions older than the timestamp or the duration will be deleted.
-        * If a few of these parameters are provided, delete action will be executed within intersection of these parameters.
-        * One of these parameters must be provided. In order to delete all actions, delete the type.
+        Warning: Please use get actions with the exact parameters first to inspect the actions to be deleted.
+        
+        * Type must be provided. 
+        * If user id is provided, all actions of the user will be deleted.
+        * If item id is provided, all actions on the item will be deleted.
+        * If older than is provided, all actions older than the timestamp or the duration will be deleted.
+        * If a number of these parameters are provided, the intersection of these parameters will be deleted.
+        * In addition to a type, at least one of these parameters must be provided. In order to delete all the actions of a type, delete the type.
       parameters:
         - name: type
           in: query
@@ -807,17 +784,16 @@ paths:
           in: query
           description: |
             Delete all actions of a type older than the given timestamp or time.
-            Valid times are 1s, 1m, 1h, 1d, 1M, 1y, or unix timestamp (like 1443798195).
+            Valid times are in form of 1s, 1m, 1h, 1d, 1M, 1y, where 1 can be any integer, or a UNIX timestamp like 1443798195.
           required: false
           type: string
-          format: id
       responses:
         200:
           description: Successfully deleted actions.
           schema:
             $ref: '#/definitions/DeleteSuccessResponse'
         400:
-          description: Required `user_id` or `item_id` parameters are missing from the request body.
+          description: Required user id or item id parameters are missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
         404:
@@ -825,11 +801,7 @@ paths:
           schema:
             $ref: '#/definitions/DeleteErrorResponse'
         422:
-          description: No query parameter (`user_id`, `item_id`, or `older_than`) is given.  In order to delete all actionsdelete the type.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+          description: No query parameter (user id, item id, or older than) is given. qIn order to delete all actionsdelete the type.
           schema:
             $ref: '#/definitions/ErrorResponse'
         505:
@@ -874,8 +846,12 @@ paths:
           description: Action limit exceeded.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+        404:
+          description: Action type does not exists.
+          schema:
+            $ref: '#/definitions/ErrorResponse'
+        413:
+          description: Bulk request maximum line count exceeded.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -895,15 +871,15 @@ paths:
       tags:
         - metadata
       operationId: get_user
-      summary: Get An User
-      description: Returns an user metadata if it exists.
+      summary: Get A User
+      description: Returns a user metadata if it exists.
       responses:
         200:
-          description: Returns an user metadata.
+          description: Returns a user metadata.
           schema:
             $ref: '#/definitions/Metadata'
         404:
-          description: User not found.
+          description: User does not exists.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -921,10 +897,6 @@ paths:
           description: Deleted a user metadata.
           schema:
             $ref: '#/definitions/MessageResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -952,10 +924,6 @@ paths:
             description: Metadata is invalid.
             schema:
               $ref: '#/definitions/DetailedErrorResponse'
-          429:
-            description: Too many requests.
-            schema:
-              $ref: '#/definitions/ErrorResponse'
           default:
             description: Unexpected internal error.
             schema:
@@ -973,29 +941,25 @@ paths:
           in: query
           description: |
             The number of the users response.
-            Defaults to 10. Must be between 1 and 10.000 inclusive.
+            Defaults to 10. Must be between 1 and 10,000 inclusive.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
         - name: from
           in: query
           description: |
-            The number of users to be skipped for response.
+            The number of users to be skipped from the response.
             Defaults to 0. Must be bigger than or equal to 0.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
       responses:
         200:
           description: Get users response.
           schema:
             $ref: '#/definitions/UsersResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1005,16 +969,13 @@ paths:
         - metadata
       operationId: delete_all_users
       summary: Delete All Users
-      description: Deletes all user metadata from SuggestGrid.
+      description: |
+        Warning: Deletes all user metadata from SuggestGrid.
       responses:
         200:
           description: Deleted all user metadata.
           schema:
             $ref: '#/definitions/MessageResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1039,7 +1000,7 @@ paths:
           schema:
             $ref: '#/definitions/Metadata'
         404:
-          description: Item not found.
+          description: Item does not exists.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -1057,10 +1018,6 @@ paths:
           description: Deleted an item metadata.
           schema:
             $ref: '#/definitions/MessageResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1090,10 +1047,6 @@ paths:
           description: Metadata is invalid.
           schema:
             $ref: '#/definitions/DetailedErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1111,29 +1064,25 @@ paths:
           in: query
           description: |
             The number of the users response.
-            Defaults to 10. Must be between 1 and 10.000 inclusive.
+            Defaults to 10. Must be between 1 and 10,000 inclusive.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
         - name: from
           in: query
           description: |
-            The number of users to be skipped for response.
+            The number of users to be skipped from the response.
             Defaults to 0. Must be bigger than or equal to 0.
             This parameter must be string represetation of an integer like "1".
           required: false
           type: integer
-          format: int32
+          format: int64
       responses:
         200:
           description: Get items response.
           schema:
             $ref: '#/definitions/ItemsResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1144,17 +1093,12 @@ paths:
       operationId: delete_all_items
       summary: Delete All Items
       description: |
-        Delete all items metadata.
-        This method would flush all items metadata on SuggestGrid.
+        Warning: Deletes all item metadata from SuggestGrid.
       responses:
         200:
           description: Deleted all item metadata.
           schema:
             $ref: '#/definitions/MessageResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1190,8 +1134,8 @@ paths:
           description: Body is missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+        413:
+          description: Bulk request maximum line count exceeded.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -1229,8 +1173,8 @@ paths:
           description: Body is missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
+        413:
+          description: Bulk request maximum line count exceeded.
           schema:
             $ref: '#/definitions/ErrorResponse'
         default:
@@ -1244,11 +1188,11 @@ paths:
         - recommendation
       operationId: get_recommended_users
       summary: Get Recommended Users
-      description: Returns recommended users for the given query.
+      description: Returns recommended users for the query.
       parameters:
         - name: query
           in: body
-          description: The query for recommended users.
+          description: Query for recommended users.
           required: true
           schema:
             $ref: '#/definitions/GetRecommendedUsersBody'
@@ -1265,10 +1209,6 @@ paths:
           description: Required parameters are missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1279,11 +1219,11 @@ paths:
         - recommendation
       operationId: get_recommended_items
       summary: Get Recommended Items
-      description: Returns recommended items for the given query.
+      description: Returns recommended items for the query.
       parameters:
         - name: query
           in: body
-          description: The query for recommended items.
+          description: Query for recommended items.
           required: true
           schema:
             $ref: '#/definitions/GetRecommendedItemsBody'
@@ -1300,10 +1240,6 @@ paths:
           description: Required parameters are missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1319,7 +1255,7 @@ paths:
       parameters:
         - name: query
           in: body
-          description: The query for similar users.
+          description: Query for similar users.
           required: true
           schema:
             $ref: '#/definitions/GetSimilarUsersBody'
@@ -1336,10 +1272,6 @@ paths:
           description: Required parameters are missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema:
@@ -1354,7 +1286,7 @@ paths:
       parameters:
         - name: query
           in: body
-          description: The query for similar items.
+          description: Query for similar items.
           required: true
           schema:
             $ref: '#/definitions/GetSimilarItemsBody'
@@ -1371,10 +1303,6 @@ paths:
           description: Required parameters are missing.
           schema:
             $ref: '#/definitions/ErrorResponse'
-        429:
-          description: Too many requests.
-          schema:
-            $ref: '#/definitions/ErrorResponse'
         default:
           description: Unexpected internal error.
           schema: