appwrite 28.4.0 → 30.0.0

data/lib/appwrite/services/messaging.rb

@@ -8,7 +8,7 @@ module Appwrite
 
         # Get a list of all messages from the current Appwrite project.
         #
-        # @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: scheduledAt, deliveredAt, deliveredTotal, status, description, providerType
+        # @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: scheduledAt, deliveredAt, deliveredTotal, status, description, providerType, users, targets
         # @param [String] search Search term to filter your list results. Max length: 256 chars.
         # @param [] total When set to false, the total count returned will be 0 and will not be calculated.
         #
@@ -56,6 +56,7 @@ module Appwrite
         # @param [String] scheduled_at Scheduled delivery time for message in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format. DateTime value must be in future.
         # @param [String] reply_to_email Email address to reply to. If not set, defaults to the sender email address.
         # @param [String] reply_to_name Name of the reply to recipient. If not set, defaults to the sender name.
+        # @param [Array] emails List of email addresses to send the message to. Use this to deliver to recipients that are not backed by an Appwrite user, target, or topic.
         #
         # @return [Message]
         def create_email(
@@ -72,10 +73,9 @@ module Appwrite
             html: nil,
             scheduled_at: nil,
             reply_to_email: nil,
-            reply_to_name: nil
+            reply_to_name: nil,
+            emails: nil
         )
-            api_path = '/messaging/messages/email'
-
             if message_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
@@ -88,6 +88,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "content"')
             end
 
+            api_path = '/messaging/messages/email'
+
             api_params = {
                 messageId: message_id,
                 subject: subject,
@@ -103,6 +105,7 @@ module Appwrite
                 scheduledAt: scheduled_at,
                 replyToEmail: reply_to_email,
                 replyToName: reply_to_name,
+                emails: emails,
             }
 
             api_headers = {
@@ -139,6 +142,7 @@ module Appwrite
         # @param [Array] attachments Array of compound ID strings of bucket IDs and file IDs to be attached to the email. They should be formatted as <BUCKET_ID>:<FILE_ID>.
         # @param [String] reply_to_email Email address to reply to. Pass an empty string to restore the provider or sender default.
         # @param [String] reply_to_name Name of the reply to recipient. Pass an empty string to restore the provider or sender default.
+        # @param [Array] emails List of email addresses to send the message to. Use this to deliver to recipients that are not backed by an Appwrite user, target, or topic.
         #
         # @return [Message]
         def update_email(
@@ -155,15 +159,16 @@ module Appwrite
             scheduled_at: nil,
             attachments: nil,
             reply_to_email: nil,
-            reply_to_name: nil
+            reply_to_name: nil,
+            emails: nil
         )
-            api_path = '/messaging/messages/email/{messageId}'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/email/{messageId}'
+                .gsub('{messageId}', message_id)
+
             api_params = {
                 topics: topics,
                 users: users,
@@ -178,6 +183,7 @@ module Appwrite
                 attachments: attachments,
                 replyToEmail: reply_to_email,
                 replyToName: reply_to_name,
+                emails: emails,
             }
 
             api_headers = {
@@ -241,12 +247,12 @@ module Appwrite
             priority: nil,
             channel_id: nil
         )
-            api_path = '/messaging/messages/push'
-
             if message_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/push'
+
             api_params = {
                 messageId: message_id,
                 title: title,
@@ -334,13 +340,13 @@ module Appwrite
             priority: nil,
             channel_id: nil
         )
-            api_path = '/messaging/messages/push/{messageId}'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/push/{messageId}'
+                .gsub('{messageId}', message_id)
+
             api_params = {
                 topics: topics,
                 users: users,
@@ -398,8 +404,6 @@ module Appwrite
             draft: nil,
             scheduled_at: nil
         )
-            api_path = '/messaging/messages/sms'
-
             if message_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
@@ -408,6 +412,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "content"')
             end
 
+            api_path = '/messaging/messages/sms'
+
             api_params = {
                 messageId: message_id,
                 content: content,
@@ -456,13 +462,13 @@ module Appwrite
             draft: nil,
             scheduled_at: nil
         )
-            api_path = '/messaging/messages/sms/{messageId}'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/sms/{messageId}'
+                .gsub('{messageId}', message_id)
+
             api_params = {
                 topics: topics,
                 users: users,
@@ -496,13 +502,13 @@ module Appwrite
         def get_message(
             message_id:
         )
-            api_path = '/messaging/messages/{messageId}'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/{messageId}'
+                .gsub('{messageId}', message_id)
+
             api_params = {}
 
             api_headers = {
@@ -528,18 +534,19 @@ module Appwrite
         def delete(
             message_id:
         )
-            api_path = '/messaging/messages/{messageId}'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/{messageId}'
+                .gsub('{messageId}', message_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
                 "content-type": 'application/json',
+                "accept": 'application/json',
             }
 
             @client.call(
@@ -562,13 +569,13 @@ module Appwrite
             queries: nil,
             total: nil
         )
-            api_path = '/messaging/messages/{messageId}/targets'
-                .gsub('{messageId}', message_id)
-
-            if message_id.nil?
+            if message_id.nil? || message_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "messageId"')
             end
 
+            api_path = '/messaging/messages/{messageId}/targets'
+                .gsub('{messageId}', message_id)
+
             api_params = {
                 queries: queries,
                 total: total,
@@ -644,8 +651,6 @@ module Appwrite
             sandbox: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/apns'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -654,6 +659,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/apns'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -702,13 +709,13 @@ module Appwrite
             bundle_id: nil,
             sandbox: nil
         )
-            api_path = '/messaging/providers/apns/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/apns/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -740,7 +747,7 @@ module Appwrite
         # @param [String] name Provider name.
         # @param [] enabled Set as enabled.
         # @param [Integer] qos Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
-        # @param [Integer] expiry Default message retention in seconds for offline delivery. Max 7 days (604800).
+        # @param [Integer] expiry Default message retention in seconds for offline delivery. Max 7 days (604800). Applies to topics with a null expiry; the lowest across enabled Appwrite providers wins.
         #
         # @return [Provider]
         def create_appwrite_provider(
@@ -789,7 +796,7 @@ module Appwrite
         # @param [String] name Provider name.
         # @param [] enabled Set as enabled.
         # @param [Integer] qos Default QoS for topics on this provider (0 or 1). Null lets the subscriber choose.
-        # @param [Integer] expiry Default message retention in seconds for offline delivery. Max 7 days (604800).
+        # @param [Integer] expiry Default message retention in seconds for offline delivery. Max 7 days (604800). Applies to topics with a null expiry; the lowest across enabled Appwrite providers wins.
         #
         # @return [Provider]
         def update_appwrite_provider(
@@ -799,7 +806,7 @@ module Appwrite
             qos: nil,
             expiry: nil
         )
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
@@ -842,8 +849,6 @@ module Appwrite
             service_account_json: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/fcm'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -852,6 +857,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/fcm'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -888,13 +895,13 @@ module Appwrite
             enabled: nil,
             service_account_json: nil
         )
-            api_path = '/messaging/providers/fcm/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/fcm/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -942,8 +949,6 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/mailgun'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -952,6 +957,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/mailgun'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1006,13 +1013,13 @@ module Appwrite
             reply_to_name: nil,
             reply_to_email: nil
         )
-            api_path = '/messaging/providers/mailgun/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/mailgun/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 apiKey: api_key,
@@ -1058,8 +1065,6 @@ module Appwrite
             auth_key: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/msg91'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1068,6 +1073,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/msg91'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1110,13 +1117,13 @@ module Appwrite
             sender_id: nil,
             auth_key: nil
         )
-            api_path = '/messaging/providers/msg91/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/msg91/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1162,8 +1169,6 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/resend'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1172,6 +1177,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/resend'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1220,13 +1227,13 @@ module Appwrite
             reply_to_name: nil,
             reply_to_email: nil
         )
-            api_path = '/messaging/providers/resend/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/resend/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1274,8 +1281,6 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/sendgrid'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1284,6 +1289,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/sendgrid'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1332,13 +1339,13 @@ module Appwrite
             reply_to_name: nil,
             reply_to_email: nil
         )
-            api_path = '/messaging/providers/sendgrid/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/sendgrid/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1390,8 +1397,6 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/ses'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1400,6 +1405,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/ses'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1454,13 +1461,13 @@ module Appwrite
             reply_to_name: nil,
             reply_to_email: nil
         )
-            api_path = '/messaging/providers/ses/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/ses/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1522,8 +1529,6 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/smtp'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1536,6 +1541,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "host"')
             end
 
+            api_path = '/messaging/providers/smtp'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1602,13 +1609,13 @@ module Appwrite
             reply_to_email: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/smtp/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/smtp/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 host: host,
@@ -1658,8 +1665,6 @@ module Appwrite
             api_key: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/telesign'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1668,6 +1673,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/telesign'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1710,13 +1717,13 @@ module Appwrite
             api_key: nil,
             from: nil
         )
-            api_path = '/messaging/providers/telesign/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/telesign/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1758,8 +1765,6 @@ module Appwrite
             api_key: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/textmagic'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1768,6 +1773,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/textmagic'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1810,13 +1817,13 @@ module Appwrite
             api_key: nil,
             from: nil
         )
-            api_path = '/messaging/providers/textmagic/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/textmagic/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1844,7 +1851,7 @@ module Appwrite
         #
         # @param [String] provider_id Provider 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 Provider name.
-        # @param [String] from Sender Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.
+        # @param [String] from Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
         # @param [String] account_sid Twilio account secret ID.
         # @param [String] auth_token Twilio authentication token.
         # @param [] enabled Set as enabled.
@@ -1858,8 +1865,6 @@ module Appwrite
             auth_token: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/twilio'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1868,6 +1873,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/twilio'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -1899,7 +1906,7 @@ module Appwrite
         # @param [] enabled Set as enabled.
         # @param [String] account_sid Twilio account secret ID.
         # @param [String] auth_token Twilio authentication token.
-        # @param [String] from Sender number.
+        # @param [String] from Sender phone number or alphanumeric sender ID. Format phone numbers with a leading '+' and a country code, e.g., +16175551212.
         #
         # @return [Provider]
         def update_twilio_provider(
@@ -1910,13 +1917,13 @@ module Appwrite
             auth_token: nil,
             from: nil
         )
-            api_path = '/messaging/providers/twilio/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/twilio/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -1958,8 +1965,6 @@ module Appwrite
             api_secret: nil,
             enabled: nil
         )
-            api_path = '/messaging/providers/vonage'
-
             if provider_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
@@ -1968,6 +1973,8 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/providers/vonage'
+
             api_params = {
                 providerId: provider_id,
                 name: name,
@@ -2010,13 +2017,13 @@ module Appwrite
             api_secret: nil,
             from: nil
         )
-            api_path = '/messaging/providers/vonage/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/vonage/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {
                 name: name,
                 enabled: enabled,
@@ -2049,13 +2056,13 @@ module Appwrite
         def get_provider(
             provider_id:
         )
-            api_path = '/messaging/providers/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {}
 
             api_headers = {
@@ -2080,18 +2087,19 @@ module Appwrite
         def delete_provider(
             provider_id:
         )
-            api_path = '/messaging/providers/{providerId}'
-                .gsub('{providerId}', provider_id)
-
-            if provider_id.nil?
+            if provider_id.nil? || provider_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "providerId"')
             end
 
+            api_path = '/messaging/providers/{providerId}'
+                .gsub('{providerId}', provider_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
                 "content-type": 'application/json',
+                "accept": 'application/json',
             }
 
             @client.call(
@@ -2142,7 +2150,8 @@ module Appwrite
         # @param [String] name Topic Name.
         # @param [Array] subscribe An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
         # @param [Integer] qos MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
-        # @param [Integer] expiry Message retention in seconds for offline delivery. Max 7 days (604800).
+        # @param [Integer] expiry Message retention in seconds for offline delivery. Max 7 days (604800). Null inherits the lowest expiry of the project's enabled Appwrite providers, or the 7-day ledger window if none sets one.
+        # @param [String] description Optional description for the topic.
         #
         # @return [Topic]
         def create_topic(
@@ -2150,10 +2159,9 @@ module Appwrite
             name:,
             subscribe: nil,
             qos: nil,
-            expiry: nil
+            expiry: nil,
+            description: nil
         )
-            api_path = '/messaging/topics'
-
             if topic_id.nil?
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
@@ -2162,12 +2170,15 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "name"')
             end
 
+            api_path = '/messaging/topics'
+
             api_params = {
                 topicId: topic_id,
                 name: name,
                 subscribe: subscribe,
                 qos: qos,
                 expiry: expiry,
+                description: description,
             }
 
             api_headers = {
@@ -2194,13 +2205,13 @@ module Appwrite
         def get_topic(
             topic_id:
         )
-            api_path = '/messaging/topics/{topicId}'
-                .gsub('{topicId}', topic_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
+            api_path = '/messaging/topics/{topicId}'
+                .gsub('{topicId}', topic_id)
+
             api_params = {}
 
             api_headers = {
@@ -2224,7 +2235,8 @@ module Appwrite
         # @param [String] name Topic Name.
         # @param [Array] subscribe An array of role strings with subscribe permission. By default all users are granted with any subscribe permission. [learn more about roles](https://appwrite.io/docs/permissions#permission-roles). Maximum of 100 roles are allowed, each 64 characters long.
         # @param [Integer] qos MQTT delivery quality of service for this topic. 0 is fire-and-forget (delivered only to clients connected at publish time). 1 persists each message and replays it when a client reconnects without having acknowledged it. Null lets the subscriber choose.
-        # @param [Integer] expiry Message retention in seconds for offline delivery. Max 7 days (604800).
+        # @param [Integer] expiry Message retention in seconds for offline delivery. Max 7 days (604800). Null inherits the lowest expiry of the project's enabled Appwrite providers, or the 7-day ledger window if none sets one.
+        # @param [String] description Optional description for the topic.
         #
         # @return [Topic]
         def update_topic(
@@ -2232,20 +2244,22 @@ module Appwrite
             name: nil,
             subscribe: nil,
             qos: nil,
-            expiry: nil
+            expiry: nil,
+            description: nil
         )
-            api_path = '/messaging/topics/{topicId}'
-                .gsub('{topicId}', topic_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
+            api_path = '/messaging/topics/{topicId}'
+                .gsub('{topicId}', topic_id)
+
             api_params = {
                 name: name,
                 subscribe: subscribe,
                 qos: qos,
                 expiry: expiry,
+                description: description,
             }
 
             api_headers = {
@@ -2271,18 +2285,19 @@ module Appwrite
         def delete_topic(
             topic_id:
         )
-            api_path = '/messaging/topics/{topicId}'
-                .gsub('{topicId}', topic_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
+            api_path = '/messaging/topics/{topicId}'
+                .gsub('{topicId}', topic_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
                 "content-type": 'application/json',
+                "accept": 'application/json',
             }
 
             @client.call(
@@ -2307,13 +2322,13 @@ module Appwrite
             search: nil,
             total: nil
         )
-            api_path = '/messaging/topics/{topicId}/subscribers'
-                .gsub('{topicId}', topic_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
+            api_path = '/messaging/topics/{topicId}/subscribers'
+                .gsub('{topicId}', topic_id)
+
             api_params = {
                 queries: queries,
                 search: search,
@@ -2346,10 +2361,7 @@ module Appwrite
             subscriber_id:,
             target_id:
         )
-            api_path = '/messaging/topics/{topicId}/subscribers'
-                .gsub('{topicId}', topic_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
@@ -2361,6 +2373,9 @@ module Appwrite
                 raise Appwrite::Exception.new('Missing required parameter: "targetId"')
             end
 
+            api_path = '/messaging/topics/{topicId}/subscribers'
+                .gsub('{topicId}', topic_id)
+
             api_params = {
                 subscriberId: subscriber_id,
                 targetId: target_id,
@@ -2392,18 +2407,18 @@ module Appwrite
             topic_id:,
             subscriber_id:
         )
-            api_path = '/messaging/topics/{topicId}/subscribers/{subscriberId}'
-                .gsub('{topicId}', topic_id)
-                .gsub('{subscriberId}', subscriber_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
-            if subscriber_id.nil?
+            if subscriber_id.nil? || subscriber_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "subscriberId"')
             end
 
+            api_path = '/messaging/topics/{topicId}/subscribers/{subscriberId}'
+                .gsub('{topicId}', topic_id)
+                .gsub('{subscriberId}', subscriber_id)
+
             api_params = {}
 
             api_headers = {
@@ -2430,23 +2445,24 @@ module Appwrite
             topic_id:,
             subscriber_id:
         )
-            api_path = '/messaging/topics/{topicId}/subscribers/{subscriberId}'
-                .gsub('{topicId}', topic_id)
-                .gsub('{subscriberId}', subscriber_id)
-
-            if topic_id.nil?
+            if topic_id.nil? || topic_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "topicId"')
             end
 
-            if subscriber_id.nil?
+            if subscriber_id.nil? || subscriber_id == ''
                 raise Appwrite::Exception.new('Missing required parameter: "subscriberId"')
             end
 
+            api_path = '/messaging/topics/{topicId}/subscribers/{subscriberId}'
+                .gsub('{topicId}', topic_id)
+                .gsub('{subscriberId}', subscriber_id)
+
             api_params = {}
 
             api_headers = {
                 "X-Appwrite-Project": @client.get_config('project'),
                 "content-type": 'application/json',
+                "accept": 'application/json',
             }
 
             @client.call(