appwrite 16.0.0 → 17.0.0

data/lib/appwrite/services/databases.rb

@@ -7,6 +7,9 @@ module Appwrite
             @client = client
         end
 
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.list` instead.
+        #
         # Get a list of all databases from the current Appwrite project. You can use
         # the search parameter to filter your results.
         #
@@ -34,7 +37,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createDatabase` instead.
+        #
         # Create a new Database.
         # 
         #
@@ -73,7 +78,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.get` instead.
+        #
         # Get a database by its unique ID. This endpoint response returns a JSON
         # object with the database metadata.
         #
@@ -103,7 +110,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.update` instead.
+        #
         # Update a database by its unique ID.
         #
         # @param [String] database_id Database ID.
@@ -141,7 +150,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.delete` instead.
+        #
         # Delete a database by its unique ID. Only API keys with with databases.write
         # scope can delete a database.
         #
@@ -171,7 +182,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.listTables` instead.
+        #
         # Get a list of all collections that belong to the provided databaseId. You
         # can use the search parameter to filter your results.
         #
@@ -205,7 +218,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createTable` instead.
+        #
         # Create a new Collection. Before using this route, you should create a new
         # database resource using either a [server
         # integration](https://appwrite.io/docs/server/databases#databasesCreateCollection)
@@ -256,7 +271,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.getTable` instead.
+        #
         # Get a collection by its unique ID. This endpoint response returns a JSON
         # object with the collection metadata.
         #
@@ -292,7 +309,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateTable` instead.
+        #
         # Update a collection by its unique ID.
         #
         # @param [String] database_id Database ID.
@@ -340,7 +359,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.deleteTable` instead.
+        #
         # Delete a collection by its unique ID. Only users with write permissions
         # have access to delete this resource.
         #
@@ -376,11 +397,13 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.listColumns` instead.
+        #
         # List attributes in the collection.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [Array] queries Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: key, type, size, required, array, status, error
         #
         # @return [AttributeList]
@@ -413,12 +436,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createBooleanColumn` instead.
+        #
         # Create a boolean attribute.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [] default Default value for attribute when not provided. Cannot be set when attribute is required.
@@ -466,12 +491,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateBooleanColumn` instead.
+        #
         # Update a boolean attribute. Changing the `default` value will not update
         # already existing documents.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#createCollection).
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [] default Default value for attribute when not provided. Cannot be set when attribute is required.
@@ -523,11 +550,13 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createDatetimeColumn` instead.
+        #
         # Create a date time attribute according to the ISO 8601 standard.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#createCollection).
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for the attribute in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. Cannot be set when attribute is required.
@@ -575,12 +604,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateDatetimeColumn` instead.
+        #
         # Update a date time attribute. Changing the `default` value will not update
         # already existing documents.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
@@ -632,12 +663,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createEmailColumn` instead.
+        #
         # Create an email attribute.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
@@ -685,17 +718,19 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateEmailColumn` instead.
+        #
         # Update an email attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [String] new_key New attribute key.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeEmail]
         def update_email_attribute(database_id:, collection_id:, key:, required:, default:, new_key: nil)
@@ -743,15 +778,17 @@ module Appwrite
             )
         end
 
-        
-        # Create an enumeration attribute. The `elements` param acts as a white-list
-        # of accepted values for this attribute. 
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createEnumColumn` instead.
+        #
+        # Create an enum attribute. The `elements` param acts as a white-list of
+        # accepted values for this attribute. 
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
-        # @param [Array] elements Array of elements in enumerated type. Uses length of longest element to determine size. Maximum of 100 elements are allowed, each 255 characters long.
+        # @param [Array] elements Array of enum values.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
@@ -803,18 +840,20 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateEnumColumn` instead.
+        #
         # Update an enum attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
-        # @param [Array] elements Array of elements in enumerated type. Uses length of longest element to determine size. Maximum of 100 elements are allowed, each 255 characters long.
+        # @param [Array] elements Updated list of enum values.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [String] new_key New attribute key.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeEnum]
         def update_enum_attribute(database_id:, collection_id:, key:, elements:, required:, default:, new_key: nil)
@@ -867,18 +906,20 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createFloatColumn` instead.
+        #
         # Create a float attribute. Optionally, minimum and maximum values can be
         # provided.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [Float] min Minimum value to enforce on new documents
-        # @param [Float] max Maximum value to enforce on new documents
-        # @param [Float] default Default value for attribute when not provided. Cannot be set when attribute is required.
+        # @param [Float] min Minimum value.
+        # @param [Float] max Maximum value.
+        # @param [Float] default Default value. Cannot be set when required.
         # @param [] array Is attribute an array?
         #
         # @return [AttributeFloat]
@@ -925,19 +966,21 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateFloatColumn` instead.
+        #
         # Update a float attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [Float] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [Float] min Minimum value to enforce on new documents
-        # @param [Float] max Maximum value to enforce on new documents
-        # @param [String] new_key New attribute key.
+        # @param [Float] default Default value. Cannot be set when required.
+        # @param [Float] min Minimum value.
+        # @param [Float] max Maximum value.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeFloat]
         def update_float_attribute(database_id:, collection_id:, key:, required:, default:, min: nil, max: nil, new_key: nil)
@@ -987,18 +1030,20 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createIntegerColumn` instead.
+        #
         # Create an integer attribute. Optionally, minimum and maximum values can be
         # provided.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [Integer] min Minimum value to enforce on new documents
-        # @param [Integer] max Maximum value to enforce on new documents
-        # @param [Integer] default Default value for attribute when not provided. Cannot be set when attribute is required.
+        # @param [Integer] min Minimum value
+        # @param [Integer] max Maximum value
+        # @param [Integer] default Default value. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         #
         # @return [AttributeInteger]
@@ -1045,19 +1090,21 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateIntegerColumn` instead.
+        #
         # Update an integer attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [Integer] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [Integer] min Minimum value to enforce on new documents
-        # @param [Integer] max Maximum value to enforce on new documents
-        # @param [String] new_key New attribute key.
+        # @param [Integer] default Default value. Cannot be set when attribute is required.
+        # @param [Integer] min Minimum value
+        # @param [Integer] max Maximum value
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeInteger]
         def update_integer_attribute(database_id:, collection_id:, key:, required:, default:, min: nil, max: nil, new_key: nil)
@@ -1107,15 +1154,17 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createIpColumn` instead.
+        #
         # Create IP address attribute.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
+        # @param [String] default Default value. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         #
         # @return [AttributeIp]
@@ -1160,17 +1209,19 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateIpColumn` instead.
+        #
         # Update an ip attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
-        # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [String] new_key New attribute key.
+        # @param [String] default Default value. Cannot be set when attribute is required.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeIp]
         def update_ip_attribute(database_id:, collection_id:, key:, required:, default:, new_key: nil)
@@ -1218,14 +1269,16 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createRelationshipColumn` instead.
+        #
         # Create relationship attribute. [Learn more about relationship
         # attributes](https://appwrite.io/docs/databases-relationships#relationship-attributes).
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
-        # @param [String] related_collection_id Related Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
+        # @param [String] related_collection_id Related Collection ID.
         # @param [RelationshipType] type Relation type
         # @param [] two_way Is Two Way?
         # @param [String] key Attribute Key.
@@ -1276,12 +1329,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createStringColumn` instead.
+        #
         # Create a string attribute.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
         # @param [String] key Attribute Key.
         # @param [Integer] size Attribute size for text attributes, in number of characters.
         # @param [] required Is attribute required?
@@ -1337,18 +1392,20 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateStringColumn` instead.
+        #
         # Update a string attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [Integer] size Maximum size of the string attribute.
-        # @param [String] new_key New attribute key.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeString]
         def update_string_attribute(database_id:, collection_id:, key:, required:, default:, size: nil, new_key: nil)
@@ -1397,12 +1454,14 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createUrlColumn` instead.
+        #
         # Create a URL attribute.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
@@ -1450,17 +1509,19 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateUrlColumn` instead.
+        #
         # Update an url attribute. Changing the `default` value will not update
         # already existing documents.
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
-        # @param [String] new_key New attribute key.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeUrl]
         def update_url_attribute(database_id:, collection_id:, key:, required:, default:, new_key: nil)
@@ -1508,11 +1569,13 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.getColumn` instead.
+        #
         # Get attribute by ID.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         #
         # @return []
@@ -1548,11 +1611,13 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.deleteColumn` instead.
+        #
         # Deletes an attribute.
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         #
         # @return []
@@ -1589,16 +1654,18 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateRelationshipColumn` instead.
+        #
         # Update relationship attribute. [Learn more about relationship
         # attributes](https://appwrite.io/docs/databases-relationships#relationship-attributes).
         # 
         #
         # @param [String] database_id Database ID.
-        # @param [String] collection_id Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).
+        # @param [String] collection_id Collection ID.
         # @param [String] key Attribute Key.
         # @param [RelationMutate] on_delete Constraints option
-        # @param [String] new_key New attribute key.
+        # @param [String] new_key New Attribute Key.
         #
         # @return [AttributeRelationship]
         def update_relationship_attribute(database_id:, collection_id:, key:, on_delete: nil, new_key: nil)
@@ -1637,7 +1704,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.listRows` instead.
+        #
         # Get a list of all the user's documents in a given collection. You can use
         # the query params to filter your results.
         #
@@ -1675,7 +1744,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createRow` instead.
+        #
         # Create a new Document. Before using this route, you should create a new
         # collection resource using either a [server
         # integration](https://appwrite.io/docs/server/databases#databasesCreateCollection)
@@ -1728,7 +1799,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createRows` instead.
+        #
         # Create new Documents. Before using this route, you should create a new
         # collection resource using either a [server
         # integration](https://appwrite.io/docs/server/databases#databasesCreateCollection)
@@ -1773,7 +1846,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.upsertRows` instead.
+        #
         # Create or update Documents. Before using this route, you should create a
         # new collection resource using either a [server
         # integration](https://appwrite.io/docs/server/databases#databasesCreateCollection)
@@ -1785,7 +1860,7 @@ module Appwrite
         # @param [Array] documents Array of document data as JSON objects. May contain partial documents.
         #
         # @return [DocumentList]
-        def upsert_documents(database_id:, collection_id:, documents: nil)
+        def upsert_documents(database_id:, collection_id:, documents:)
             api_path = '/databases/{databaseId}/collections/{collectionId}/documents'
                 .gsub('{databaseId}', database_id)
                 .gsub('{collectionId}', collection_id)
@@ -1798,6 +1873,10 @@ module Appwrite
               raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
             end
 
+            if documents.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "documents"')
+            end
+
             api_params = {
                 documents: documents,
             }
@@ -1815,7 +1894,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateRows` instead.
+        #
         # Update all documents that match your queries, if no queries are submitted
         # then all documents are updated. You can pass only specific fields to be
         # updated.
@@ -1857,7 +1938,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.deleteRows` instead.
+        #
         # Bulk delete documents using queries, if no queries are passed then all
         # documents are deleted.
         #
@@ -1896,7 +1979,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.getRow` instead.
+        #
         # Get a document by its unique ID. This endpoint response returns a JSON
         # object with the document data.
         #
@@ -1940,7 +2025,64 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.upsertRow` instead.
+        #
+        # Create or update a Document. Before using this route, you should create a
+        # new collection resource using either a [server
+        # integration](https://appwrite.io/docs/server/databases#databasesCreateCollection)
+        # API or directly from your database console.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] collection_id Collection ID.
+        # @param [String] document_id Document ID.
+        # @param [Hash] data Document data as JSON object. Include all required attributes of the document to be created or updated.
+        # @param [Array] permissions An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https://appwrite.io/docs/permissions).
+        #
+        # @return [Document]
+        def upsert_document(database_id:, collection_id:, document_id:, data:, permissions: nil)
+            api_path = '/databases/{databaseId}/collections/{collectionId}/documents/{documentId}'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+                .gsub('{documentId}', document_id)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            if document_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "documentId"')
+            end
+
+            if data.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "data"')
+            end
+
+            api_params = {
+                data: data,
+                permissions: permissions,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PUT',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Document
+            )
+        end
+
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.updateRow` instead.
+        #
         # Update a document by its unique ID. Using the patch method you can pass
         # only specific fields that will get updated.
         #
@@ -1987,7 +2129,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.deleteRow` instead.
+        #
         # Delete a document by its unique ID.
         #
         # @param [String] database_id Database ID.
@@ -2028,7 +2172,117 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.decrementRowColumn` instead.
+        #
+        # Decrement a specific attribute of a document by a given value.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] collection_id Collection ID.
+        # @param [String] document_id Document ID.
+        # @param [String] attribute Attribute key.
+        # @param [Float] value Value to increment the attribute by. The value must be a number.
+        # @param [Float] min Minimum value for the attribute. If the current value is lesser than this value, an exception will be thrown.
+        #
+        # @return [Document]
+        def decrement_document_attribute(database_id:, collection_id:, document_id:, attribute:, value: nil, min: nil)
+            api_path = '/databases/{databaseId}/collections/{collectionId}/documents/{documentId}/{attribute}/decrement'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+                .gsub('{documentId}', document_id)
+                .gsub('{attribute}', attribute)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            if document_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "documentId"')
+            end
+
+            if attribute.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "attribute"')
+            end
+
+            api_params = {
+                value: value,
+                min: min,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PATCH',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Document
+            )
+        end
+
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.incrementRowColumn` instead.
+        #
+        # Increment a specific attribute of a document by a given value.
+        #
+        # @param [String] database_id Database ID.
+        # @param [String] collection_id Collection ID.
+        # @param [String] document_id Document ID.
+        # @param [String] attribute Attribute key.
+        # @param [Float] value Value to increment the attribute by. The value must be a number.
+        # @param [Float] max Maximum value for the attribute. If the current value is greater than this value, an error will be thrown.
+        #
+        # @return [Document]
+        def increment_document_attribute(database_id:, collection_id:, document_id:, attribute:, value: nil, max: nil)
+            api_path = '/databases/{databaseId}/collections/{collectionId}/documents/{documentId}/{attribute}/increment'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+                .gsub('{documentId}', document_id)
+                .gsub('{attribute}', attribute)
+
+            if database_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            if document_id.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "documentId"')
+            end
+
+            if attribute.nil?
+              raise Appwrite::Exception.new('Missing required parameter: "attribute"')
+            end
+
+            api_params = {
+                value: value,
+                max: max,
+            }
+            
+            api_headers = {
+                "content-type": 'application/json',
+            }
+
+            @client.call(
+                method: 'PATCH',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::Document
+            )
+        end
+
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.listIndexes` instead.
+        #
         # List indexes in the collection.
         #
         # @param [String] database_id Database ID.
@@ -2065,7 +2319,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createIndex` instead.
+        #
         # Creates an index on the attributes listed. Your index should include all
         # the attributes you will query in a single request.
         # Attributes can be `key`, `fulltext`, and `unique`.
@@ -2125,7 +2381,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.getIndex` instead.
+        #
         # Get index by ID.
         #
         # @param [String] database_id Database ID.
@@ -2166,7 +2424,9 @@ module Appwrite
             )
         end
 
-        
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.deleteIndex` instead.
+        #
         # Delete an index.
         #
         # @param [String] database_id Database ID.
@@ -2207,6 +2467,5 @@ module Appwrite
             )
         end
 
-        
     end 
 end