lib_discord 0.1.0.pre2 → 0.1.0

data/lib/lib_discord/guild.rb

@@ -0,0 +1,830 @@
+# frozen_string_literal: true
+
+require "lib_discord/resource"
+
+module LibDiscord
+  ##
+  # Guild Resource
+  #
+  # Do not instantiate a {Guild} directly. Instead request one from an instance
+  # of {Client}.
+  #
+  #   client = LibDiscord::Client.new("Bot auth.token")
+  #   g = client["guild"]
+  #
+  # @see https://discord.com/developers/docs/resources/guild Discord
+  #   documentation "Guild Resource"
+  class Guild < Resource
+    ##
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#create-guild
+    #   Discord documentation "Create Guild"
+    def create_guild(json:)
+      send_request(:post, "/guilds", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild
+    #   Discord documentation "Get Guild"
+    def get_guild(guild_id:, params: {})
+      send_request(:get, "/guilds/#{guild_id}", params:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-preview
+    #   Discord documentation "Get Guild Preview"
+    def get_guild_preview(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/preview")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild
+    #   Discord documentation "Modify Guild"
+    def modify_guild(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#delete-guild
+    #   Discord documentation "Delete Guild"
+    def delete_guild(guild_id:)
+      send_request(:delete, "/guilds/#{guild_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-channels
+    #   Discord documentation "Get Guild Channels"
+    def get_guild_channels(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/channels")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#create-guild-channel
+    #   Discord documentation "Create Guild Channel"
+    def create_guild_channel(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/channels", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-channel-positions
+    #   Discord documentation "Modify Guild Channel Positions"
+    def modify_guild_channel_positions(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/channels", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#list-active-guild-threads
+    #   Discord documentation "List Active Guild Threads"
+    def list_active_guild_threads(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/threads/active")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-member
+    #   Discord documentation "Get Guild Member"
+    def get_guild_member(guild_id:, user_id:)
+      send_request(:get, "/guilds/#{guild_id}/members/#{user_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#list-guild-members
+    #   Discord documentation "List Guild Members"
+    def list_guild_members(guild_id:, params: {})
+      send_request(:get, "/guilds/#{guild_id}/members", params:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#search-guild-members
+    #   Discord documentation "Search Guild Members"
+    def search_guild_members(guild_id:, params: {})
+      send_request(:get, "/guilds/#{guild_id}/members/search", params:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#add-guild-member
+    #   Discord documentation "Add Guild Member"
+    def add_guild_member(guild_id:, user_id:, json:)
+      send_request(:put, "/guilds/#{guild_id}/members/#{user_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-member
+    #   Discord documentation "Modify Guild Member"
+    def modify_guild_member(guild_id:, user_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/members/#{user_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-current-member
+    #   Discord documentation "Modify Current Member"
+    def modify_current_member(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/members/@me", json:)
+    end
+
+    ##
+    # @deprecated Use {#modify_current_member} instead.
+    #
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-current-user-nick
+    #   Discord documentation "Modify Current User Nick"
+    def modify_current_user_nick(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/members/@me/nick", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param role_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#add-guild-member-role
+    #   Discord documentation "Add Guild Member Role"
+    def add_guild_member_role(guild_id:, user_id:, role_id:)
+      send_request(:put, "/guilds/#{guild_id}/members/#{user_id}/roles/#{role_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param role_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#remove-guild-member-role
+    #   Discord documentation "Remove Guild Member Role"
+    def remove_guild_member_role(guild_id:, user_id:, role_id:)
+      send_request(:delete, "/guilds/#{guild_id}/members/#{user_id}/roles/#{role_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#remove-guild-member
+    #   Discord documentation "Remove Guild Member"
+    def remove_guild_member(guild_id:, user_id:)
+      send_request(:delete, "/guilds/#{guild_id}/members/#{user_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-bans
+    #   Discord documentation "Get Guild Bans"
+    def get_guild_bans(guild_id:, params: {})
+      send_request(:get, "/guilds/#{guild_id}/bans", params:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-ban
+    #   Discord documentation "Get Guild Ban"
+    def get_guild_ban(guild_id:, user_id:)
+      send_request(:get, "/guilds/#{guild_id}/bans/#{user_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#create-guild-ban
+    #   Discord documentation "Create Guild Ban"
+    def create_guild_ban(guild_id:, user_id:, json:)
+      send_request(:put, "/guilds/#{guild_id}/bans/#{user_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#remove-guild-ban
+    #   Discord documentation "Remove Guild Ban"
+    def remove_guild_ban(guild_id:, user_id:)
+      send_request(:delete, "/guilds/#{guild_id}/bans/#{user_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#bulk-guild-ban
+    #   Discord documentation "Bulk Guild Ban"
+    def bulk_guild_ban(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/bulk-ban", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-roles
+    #   Discord documentation "Get Guild Roles"
+    def get_guild_roles(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/roles")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#create-guild-role
+    #   Discord documentation "Create Guild Role"
+    def create_guild_role(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/roles", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-role-positions
+    #   Discord documentation "Modify Guild Role Positions"
+    def modify_guild_role_positions(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/roles", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param role_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-role
+    #   Discord documentation "Modify Guild Role"
+    def modify_guild_role(guild_id:, role_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/roles/#{role_id}", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-mfa-level
+    #   Discord documentation "Modify Guild MFA level"
+    def modify_guild_mfa_level(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/mfa", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param role_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#delete-guild-role
+    #   Discord documentation "Delete Guild Role"
+    def delete_guild_role(guild_id:, role_id:)
+      send_request(:delete, "/guilds/#{guild_id}/roles/#{role_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-prune-count
+    #   Discord documentation "Get Guild Prune Count"
+    def get_guild_prune_count(guild_id:, params: {})
+      send_request(:get, "/guilds/#{guild_id}/prune", params:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#begin-guild-prune
+    #   Discord documentation "Begin Guild Prune"
+    def begin_guild_prune(guild_id:, json:)
+      send_request(:post, "/guilds/#{guild_id}/prune", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-voice-regions
+    #   Discord documentation "Get Guild Voice Regions"
+    def get_guild_voice_regions(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/regions")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-invites
+    #   Discord documentation "Get Guild Invites"
+    def get_guild_invites(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/invites")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-integrations
+    #   Discord documentation "Get Guild Integrations"
+    def get_guild_integrations(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/integrations")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param integration_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#delete-guild-integration
+    #   Discord documentation "Delete Guild Integration"
+    def delete_guild_integration(guild_id:, integration_id:)
+      send_request(:delete, "/guilds/#{guild_id}/integrations/#{integration_id}")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-widget-settings
+    #   Discord documentation "Get Guild Widget Settings"
+    def get_guild_widget_settings(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/widget")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-widget
+    #   Discord documentation "Modify Guild Widget"
+    def modify_guild_widget(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/widget", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-widget
+    #   Discord documentation "Get Guild Widget"
+    def get_guild_widget(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/widget.json")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-vanity-url
+    #   Discord documentation "Get Guild Vanity URL"
+    def get_guild_vanity_url(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/vanity-url")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param params [Hash] optional HTTP query parameters
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +params+ cannot be coerced into a valid query
+    #   parameters string
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-widget-image
+    #   Discord documentation "Get Guild Widget Image"
+    def get_guild_widget_image(guild_id:, params: {})
+      send_request(
+        :get,
+        "/guilds/#{guild_id}/widget.png",
+        http_client: client,
+        params:
+      )
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-welcome-screen
+    #   Discord documentation "Get Guild Welcome Screen"
+    def get_guild_welcome_screen(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/welcome-screen")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen
+    #   Discord documentation "Modify Guild Welcome Screen"
+    def modify_guild_welcome_screen(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/welcome-screen", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    #
+    # @see https://discord.com/developers/docs/resources/guild#get-guild-onboarding
+    #   Discord documentation "Get Guild Onboarding"
+    def get_guild_onboarding(guild_id:)
+      send_request(:get, "/guilds/#{guild_id}/onboarding")
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-guild-onboarding
+    #   Discord documentation "Modify Guild Onboarding"
+    def modify_guild_onboarding(guild_id:, json:)
+      send_request(:put, "/guilds/#{guild_id}/onboarding", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state
+    #   Discord documentation "Modify Current User Voice State"
+    def modify_current_user_voice_state(guild_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/voice-states/@me", json:)
+    end
+
+    ##
+    # @param guild_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param user_id [#to_s]
+    #   {https://discord.com/developers/docs/reference#snowflakes Discord
+    #   documentation "Snowflakes"}
+    # @param json [Hash] JSON serializable payload
+    #
+    # @return [Response]
+    #
+    # @raise [TimeoutError] if the HTTP request times out
+    # @raise [ConstraintError] if +json+ cannot be serialized to JSON
+    #
+    # @see https://discord.com/developers/docs/resources/guild#modify-user-voice-state
+    #   Discord documentation "Modify User Voice State"
+    def modify_user_voice_state(guild_id:, user_id:, json:)
+      send_request(:patch, "/guilds/#{guild_id}/voice-states/#{user_id}", json:)
+    end
+  end
+end