appwrite 29.0.0 → 30.0.0

data/lib/appwrite/services/databases.rb

@@ -53,12 +53,14 @@ module Appwrite
         # @param [String] database_id Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.
         # @param [String] name Database name. Max length: 128 chars.
         # @param [] enabled Is the database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
+        # @param [String] description Optional description for the database.
         #
         # @return [Database]
         def create(
             database_id:,
             name:,
-            enabled: nil
+            enabled: nil,
+            description: nil
         )
             if database_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -74,6 +76,7 @@ module Appwrite
                 databaseId: database_id,
                 name: name,
                 enabled: enabled,
+                description: description,
             }
 
             api_headers = {
@@ -349,12 +352,14 @@ module Appwrite
         # @param [String] database_id Database ID.
         # @param [String] name Database name. Max length: 128 chars.
         # @param [] enabled Is database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.
+        # @param [String] description Optional description for the database.
         #
         # @return [Database]
         def update(
             database_id:,
             name: nil,
-            enabled: nil
+            enabled: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -366,6 +371,7 @@ module Appwrite
             api_params = {
                 name: name,
                 enabled: enabled,
+                description: description,
             }
 
             api_headers = {
@@ -479,6 +485,7 @@ module Appwrite
         # @param [] enabled Is collection enabled? When set to 'disabled', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.
         # @param [Array] attributes Array of attribute definitions to create. Each attribute should contain: key (string), type (string: string, varchar, text, mediumtext, longtext, integer, bigint, double, boolean, datetime, point, linestring, polygon, email, url, ip, enum), size (integer, required for string and varchar types), required (boolean, optional), default (mixed, optional), array (boolean, optional), and type-specific options.
         # @param [Array] indexes Array of index definitions to create. Each index should contain: key (string), type (string: key, fulltext, unique, spatial, trigram), attributes (array of attribute keys), orders (array of ASC/DESC, optional), and lengths (array of integers, optional).
+        # @param [String] description Optional description for the collection.
         #
         # @return [Collection]
         def create_collection(
@@ -489,7 +496,8 @@ module Appwrite
             document_security: nil,
             enabled: nil,
             attributes: nil,
-            indexes: nil
+            indexes: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -514,6 +522,7 @@ module Appwrite
                 enabled: enabled,
                 attributes: attributes,
                 indexes: indexes,
+                description: description,
             }
 
             api_headers = {
@@ -585,6 +594,7 @@ module Appwrite
         # @param [] document_security Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).
         # @param [] enabled Is collection enabled? When set to 'disabled', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.
         # @param [] purge When true, purge all cached list responses for this collection as part of the update. Use this to force readers to see fresh data immediately instead of waiting for the cache TTL to expire.
+        # @param [String] description Optional description for the collection.
         #
         # @return [Collection]
         def update_collection(
@@ -594,7 +604,8 @@ module Appwrite
             permissions: nil,
             document_security: nil,
             enabled: nil,
-            purge: nil
+            purge: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -614,6 +625,7 @@ module Appwrite
                 documentSecurity: document_security,
                 enabled: enabled,
                 purge: purge,
+                description: description,
             }
 
             api_headers = {
@@ -736,6 +748,7 @@ module Appwrite
         # @param [Integer] max Maximum value
         # @param [Integer] default Default value. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeBigint]
         def create_big_int_attribute(
@@ -746,7 +759,8 @@ module Appwrite
             min: nil,
             max: nil,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -775,6 +789,7 @@ module Appwrite
                 max: max,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -807,6 +822,7 @@ module Appwrite
         # @param [Integer] min Minimum value
         # @param [Integer] max Maximum value
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeBigint]
         def update_big_int_attribute(
@@ -817,7 +833,8 @@ module Appwrite
             default:,
             min: nil,
             max: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -850,6 +867,7 @@ module Appwrite
                 max: max,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -879,6 +897,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeBoolean]
         def create_boolean_attribute(
@@ -887,7 +906,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -914,6 +934,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -943,6 +964,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [String] new_key New attribute key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeBoolean]
         def update_boolean_attribute(
@@ -951,7 +973,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -982,6 +1005,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1010,6 +1034,7 @@ module Appwrite
         # @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.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeDatetime]
         def create_datetime_attribute(
@@ -1018,7 +1043,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1045,6 +1071,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1074,6 +1101,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeDatetime]
         def update_datetime_attribute(
@@ -1082,7 +1110,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1113,6 +1142,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1142,6 +1172,7 @@ module Appwrite
         # @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?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeEmail]
         def create_email_attribute(
@@ -1150,7 +1181,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1177,6 +1209,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1207,6 +1240,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeEmail]
         def update_email_attribute(
@@ -1215,7 +1249,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1246,6 +1281,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1277,6 +1313,7 @@ module Appwrite
         # @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?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeEnum]
         def create_enum_attribute(
@@ -1286,7 +1323,8 @@ module Appwrite
             elements:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1318,6 +1356,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1349,6 +1388,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeEnum]
         def update_enum_attribute(
@@ -1358,7 +1398,8 @@ module Appwrite
             elements:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1394,6 +1435,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1426,6 +1468,7 @@ module Appwrite
         # @param [Float] max Maximum value.
         # @param [Float] default Default value. Cannot be set when required.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeFloat]
         def create_float_attribute(
@@ -1436,7 +1479,8 @@ module Appwrite
             min: nil,
             max: nil,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1465,6 +1509,7 @@ module Appwrite
                 max: max,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1497,6 +1542,7 @@ module Appwrite
         # @param [Float] min Minimum value.
         # @param [Float] max Maximum value.
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeFloat]
         def update_float_attribute(
@@ -1507,7 +1553,8 @@ module Appwrite
             default:,
             min: nil,
             max: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1540,6 +1587,7 @@ module Appwrite
                 max: max,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1572,6 +1620,7 @@ module Appwrite
         # @param [Integer] max Maximum value
         # @param [Integer] default Default value. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeInteger]
         def create_integer_attribute(
@@ -1582,7 +1631,8 @@ module Appwrite
             min: nil,
             max: nil,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1611,6 +1661,7 @@ module Appwrite
                 max: max,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1643,6 +1694,7 @@ module Appwrite
         # @param [Integer] min Minimum value
         # @param [Integer] max Maximum value
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeInteger]
         def update_integer_attribute(
@@ -1653,7 +1705,8 @@ module Appwrite
             default:,
             min: nil,
             max: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1686,6 +1739,7 @@ module Appwrite
                 max: max,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1715,6 +1769,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [String] default Default value. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeIp]
         def create_ip_attribute(
@@ -1723,7 +1778,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1750,6 +1806,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -1780,6 +1837,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [String] default Default value. Cannot be set when attribute is required.
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeIp]
         def update_ip_attribute(
@@ -1788,7 +1846,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1819,6 +1878,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1846,6 +1906,7 @@ module Appwrite
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, two-dimensional array of coordinate pairs, [[longitude, latitude], [longitude, latitude], …], listing the vertices of the line in order. Cannot be set when attribute is required.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeLine]
         def create_line_attribute(
@@ -1853,7 +1914,8 @@ module Appwrite
             collection_id:,
             key:,
             required:,
-            default: nil
+            default: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1879,6 +1941,7 @@ module Appwrite
                 key: key,
                 required: required,
                 default: default,
+                description: description,
             }
 
             api_headers = {
@@ -1908,6 +1971,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, two-dimensional array of coordinate pairs, [[longitude, latitude], [longitude, latitude], …], listing the vertices of the line in order. Cannot be set when attribute is required.
         # @param [String] new_key New attribute key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeLine]
         def update_line_attribute(
@@ -1916,7 +1980,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -1943,6 +2008,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -1973,6 +2039,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         # @param [] encrypt Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeLongtext]
         def create_longtext_attribute(
@@ -1982,7 +2049,8 @@ module Appwrite
             required:,
             default: nil,
             array: nil,
-            encrypt: nil
+            encrypt: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2010,6 +2078,7 @@ module Appwrite
                 default: default,
                 array: array,
                 encrypt: encrypt,
+                description: description,
             }
 
             api_headers = {
@@ -2040,6 +2109,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeLongtext]
         def update_longtext_attribute(
@@ -2048,7 +2118,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2079,6 +2150,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2109,6 +2181,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         # @param [] encrypt Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeMediumtext]
         def create_mediumtext_attribute(
@@ -2118,7 +2191,8 @@ module Appwrite
             required:,
             default: nil,
             array: nil,
-            encrypt: nil
+            encrypt: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2146,6 +2220,7 @@ module Appwrite
                 default: default,
                 array: array,
                 encrypt: encrypt,
+                description: description,
             }
 
             api_headers = {
@@ -2176,6 +2251,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeMediumtext]
         def update_mediumtext_attribute(
@@ -2184,7 +2260,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2215,6 +2292,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2242,6 +2320,7 @@ module Appwrite
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, array of two numbers [longitude, latitude], representing a single coordinate. Cannot be set when attribute is required.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributePoint]
         def create_point_attribute(
@@ -2249,7 +2328,8 @@ module Appwrite
             collection_id:,
             key:,
             required:,
-            default: nil
+            default: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2275,6 +2355,7 @@ module Appwrite
                 key: key,
                 required: required,
                 default: default,
+                description: description,
             }
 
             api_headers = {
@@ -2304,6 +2385,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, array of two numbers [longitude, latitude], representing a single coordinate. Cannot be set when attribute is required.
         # @param [String] new_key New attribute key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributePoint]
         def update_point_attribute(
@@ -2312,7 +2394,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2339,6 +2422,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2366,6 +2450,7 @@ module Appwrite
         # @param [String] key Attribute Key.
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, three-dimensional array where the outer array holds one or more linear rings, [[[longitude, latitude], …], …], the first ring is the exterior boundary, any additional rings are interior holes, and each ring must start and end with the same coordinate pair. Cannot be set when attribute is required.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributePolygon]
         def create_polygon_attribute(
@@ -2373,7 +2458,8 @@ module Appwrite
             collection_id:,
             key:,
             required:,
-            default: nil
+            default: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2399,6 +2485,7 @@ module Appwrite
                 key: key,
                 required: required,
                 default: default,
+                description: description,
             }
 
             api_headers = {
@@ -2428,6 +2515,7 @@ module Appwrite
         # @param [] required Is attribute required?
         # @param [Array] default Default value for attribute when not provided, three-dimensional array where the outer array holds one or more linear rings, [[[longitude, latitude], …], …], the first ring is the exterior boundary, any additional rings are interior holes, and each ring must start and end with the same coordinate pair. Cannot be set when attribute is required.
         # @param [String] new_key New attribute key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributePolygon]
         def update_polygon_attribute(
@@ -2436,7 +2524,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2463,6 +2552,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2495,6 +2585,7 @@ module Appwrite
         # @param [String] key Attribute Key.
         # @param [String] two_way_key Two Way Attribute Key.
         # @param [RelationMutate] on_delete Delete constraint. Possible values are: cascade, restrict, setNull.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeRelationship]
         def create_relationship_attribute(
@@ -2505,7 +2596,8 @@ module Appwrite
             two_way: nil,
             key: nil,
             two_way_key: nil,
-            on_delete: nil
+            on_delete: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2534,6 +2626,7 @@ module Appwrite
                 key: key,
                 twoWayKey: two_way_key,
                 onDelete: on_delete,
+                description: description,
             }
 
             api_headers = {
@@ -2563,6 +2656,7 @@ module Appwrite
         # @param [String] key Attribute Key.
         # @param [RelationMutate] on_delete Delete constraint. Possible values are: cascade, restrict, setNull.
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeRelationship]
         def update_relationship_attribute(
@@ -2570,7 +2664,8 @@ module Appwrite
             collection_id:,
             key:,
             on_delete: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2592,6 +2687,7 @@ module Appwrite
             api_params = {
                 onDelete: on_delete,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2623,6 +2719,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         # @param [] encrypt Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeString]
         def create_string_attribute(
@@ -2633,7 +2730,8 @@ module Appwrite
             required:,
             default: nil,
             array: nil,
-            encrypt: nil
+            encrypt: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2666,6 +2764,7 @@ module Appwrite
                 default: default,
                 array: array,
                 encrypt: encrypt,
+                description: description,
             }
 
             api_headers = {
@@ -2697,6 +2796,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeString]
         def update_string_attribute(
@@ -2706,7 +2806,8 @@ module Appwrite
             required:,
             default:,
             size: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2738,6 +2839,7 @@ module Appwrite
                 default: default,
                 size: size,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2768,6 +2870,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         # @param [] encrypt Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeText]
         def create_text_attribute(
@@ -2777,7 +2880,8 @@ module Appwrite
             required:,
             default: nil,
             array: nil,
-            encrypt: nil
+            encrypt: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2805,6 +2909,7 @@ module Appwrite
                 default: default,
                 array: array,
                 encrypt: encrypt,
+                description: description,
             }
 
             api_headers = {
@@ -2835,6 +2940,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeText]
         def update_text_attribute(
@@ -2843,7 +2949,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2874,6 +2981,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -2903,6 +3011,7 @@ module Appwrite
         # @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?
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeUrl]
         def create_url_attribute(
@@ -2911,7 +3020,8 @@ module Appwrite
             key:,
             required:,
             default: nil,
-            array: nil
+            array: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -2938,6 +3048,7 @@ module Appwrite
                 required: required,
                 default: default,
                 array: array,
+                description: description,
             }
 
             api_headers = {
@@ -2968,6 +3079,7 @@ module Appwrite
         # @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] description Optional description for the attribute.
         #
         # @return [AttributeUrl]
         def update_url_attribute(
@@ -2976,7 +3088,8 @@ module Appwrite
             key:,
             required:,
             default:,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -3007,6 +3120,7 @@ module Appwrite
                 required: required,
                 default: default,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -3038,6 +3152,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [] array Is attribute an array?
         # @param [] encrypt Toggle encryption for the attribute. Encryption enhances security by not storing any plain text values in the database. However, encrypted attributes cannot be queried.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeVarchar]
         def create_varchar_attribute(
@@ -3048,7 +3163,8 @@ module Appwrite
             required:,
             default: nil,
             array: nil,
-            encrypt: nil
+            encrypt: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -3081,6 +3197,7 @@ module Appwrite
                 default: default,
                 array: array,
                 encrypt: encrypt,
+                description: description,
             }
 
             api_headers = {
@@ -3112,6 +3229,7 @@ module Appwrite
         # @param [String] default Default value for attribute when not provided. Cannot be set when attribute is required.
         # @param [Integer] size Maximum size of the varchar attribute.
         # @param [String] new_key New Attribute Key.
+        # @param [String] description Optional description for the attribute.
         #
         # @return [AttributeVarchar]
         def update_varchar_attribute(
@@ -3121,7 +3239,8 @@ module Appwrite
             required:,
             default:,
             size: nil,
-            new_key: nil
+            new_key: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -3153,6 +3272,7 @@ module Appwrite
                 default: default,
                 size: size,
                 newKey: new_key,
+                description: description,
             }
 
             api_headers = {
@@ -3367,12 +3487,21 @@ module Appwrite
         # Get a list of all the user's documents in a given collection. You can use
         # the query params to filter your results.
         #
+        # Documents returned by aggregate, groupBy or distinct queries hold only the
+        # attributes they select, group or aggregate, typed as a document types them,
+        # with a joined attribute named by its join alias (`alias.attribute`). The
+        # response omits their `$id`, `$sequence`, `$createdAt`, `$updatedAt`,
+        # `$permissions`, `$databaseId` and `$collectionId` unless they select or
+        # group it, and those of a right or full join document that no document of
+        # this collection matched. SDK document models fill omitted system attributes
+        # with empty values.
+        #
         # @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 [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.
         # @param [String] transaction_id Transaction ID to read uncommitted changes within the transaction.
         # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
-        # @param [Integer] ttl TTL (seconds) for caching list responses. Responses are stored in an in-memory key-value cache, keyed per project, collection, schema version (attributes and indexes), caller authorization roles, and the exact query — so users with different permissions never share cached entries. Schema changes invalidate cached entries automatically; document writes do not, so choose a TTL you are comfortable serving as stale data. Set to 0 to disable caching. Must be between 0 and 86400 (24 hours).
+        # @param [Integer] ttl TTL (seconds) for caching list responses. Responses are stored in an in-memory key-value cache, keyed per project, collection, schema version (attributes and indexes), caller authorization roles, and the exact query — so users with different permissions never share cached entries. Schema changes invalidate cached entries automatically; document writes do not, so choose a TTL you are comfortable serving as stale data. Set to 0 to disable caching. Lists with join queries are not cached. Must be between 0 and 86400 (24 hours).
         #
         # @return [DocumentList]
         def list_documents(
@@ -3699,6 +3828,65 @@ module Appwrite
             )
         end
 
+        #
+        # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.createQuery` instead.
+        #
+        # Get a list of all the user's documents in a given collection using a POST
+        # request. This behaves identically to the list documents endpoint but
+        # accepts the queries in the request body, allowing much larger `queries`
+        # arrays than can fit in a URL query string.
+        #
+        #
+        # @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 [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.
+        # @param [String] transaction_id Transaction ID to read uncommitted changes within the transaction.
+        # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
+        # @param [Integer] ttl TTL (seconds) for caching list responses. Responses are stored in an in-memory key-value cache, keyed per project, collection, schema version (attributes and indexes), caller authorization roles, and the exact query — so users with different permissions never share cached entries. Schema changes invalidate cached entries automatically; document writes do not, so choose a TTL you are comfortable serving as stale data. Set to 0 to disable caching. Lists with join queries are not cached. Must be between 0 and 86400 (24 hours).
+        #
+        # @return [DocumentList]
+        def create_query(
+            database_id:,
+            collection_id:,
+            queries: nil,
+            transaction_id: nil,
+            total: nil,
+            ttl: nil
+        )
+            if database_id.nil? || database_id == ''
+                raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
+            end
+
+            if collection_id.nil? || collection_id == ''
+                raise Appwrite::Exception.new('Missing required parameter: "collectionId"')
+            end
+
+            api_path = '/databases/{databaseId}/collections/{collectionId}/documents/query'
+                .gsub('{databaseId}', database_id)
+                .gsub('{collectionId}', collection_id)
+
+            api_params = {
+                queries: queries,
+                transactionId: transaction_id,
+                total: total,
+                ttl: ttl,
+            }
+
+            api_headers = {
+                "X-Appwrite-Project": @client.get_config('project'),
+                "content-type": 'application/json',
+                "accept": 'application/json',
+            }
+
+            @client.call(
+                method: 'POST',
+                path: api_path,
+                headers: api_headers,
+                params: api_params,
+                response_type: Models::DocumentList
+            )
+        end
+
         #
         # @deprecated This API has been deprecated since 1.8.0. Please use `TablesDB.getRow` instead.
         #
@@ -4125,6 +4313,7 @@ module Appwrite
         # @param [Array] attributes Array of attributes to index. Maximum of 100 attributes are allowed, each 32 characters long.
         # @param [Array] orders Array of index orders. Maximum of 100 orders are allowed.
         # @param [Array] lengths Length of index. Maximum of 100
+        # @param [String] description Optional description for the index.
         #
         # @return [Index]
         def create_index(
@@ -4134,7 +4323,8 @@ module Appwrite
             type:,
             attributes:,
             orders: nil,
-            lengths: nil
+            lengths: nil,
+            description: nil
         )
             if database_id.nil? || database_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "databaseId"')
@@ -4166,6 +4356,7 @@ module Appwrite
                 attributes: attributes,
                 orders: orders,
                 lengths: lengths,
+                description: description,
             }
 
             api_headers = {