mudbase 1.1.4

data/lib/mudbase/api/multi_role_feature_api.rb

@@ -0,0 +1,699 @@
+=begin
+#MUDBASESDK
+
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'cgi'
+
+module Mudbase
+  class MultiRoleFeatureApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Add custom role
+    # Add a custom role to a project with specific permissions and signup endpoint. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param add_custom_role_request [AddCustomRoleRequest] Custom role definition (slug, name, description, signupEndpoint, hierarchy, defaultPermissions).
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateMultiRoleSettings200Response]
+    def add_custom_role(project_id, add_custom_role_request, opts = {})
+      data, _status_code, _headers = add_custom_role_with_http_info(project_id, add_custom_role_request, opts)
+      data
+    end
+
+    # Add custom role
+    # Add a custom role to a project with specific permissions and signup endpoint. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param add_custom_role_request [AddCustomRoleRequest] Custom role definition (slug, name, description, signupEndpoint, hierarchy, defaultPermissions).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateMultiRoleSettings200Response, Integer, Hash)>] UpdateMultiRoleSettings200Response data, response status code and response headers
+    def add_custom_role_with_http_info(project_id, add_custom_role_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.add_custom_role ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.add_custom_role"
+      end
+      # verify the required parameter 'add_custom_role_request' is set
+      if @api_client.config.client_side_validation && add_custom_role_request.nil?
+        fail ArgumentError, "Missing the required parameter 'add_custom_role_request' when calling MultiRoleFeatureApi.add_custom_role"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/roles'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(add_custom_role_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateMultiRoleSettings200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.add_custom_role",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#add_custom_role\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get available roles for signup
+    # Get all available roles for user signup in a project. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @return [GetAvailableRoles200Response]
+    def get_available_roles(project_id, opts = {})
+      data, _status_code, _headers = get_available_roles_with_http_info(project_id, opts)
+      data
+    end
+
+    # Get available roles for signup
+    # Get all available roles for user signup in a project. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetAvailableRoles200Response, Integer, Hash)>] GetAvailableRoles200Response data, response status code and response headers
+    def get_available_roles_with_http_info(project_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.get_available_roles ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.get_available_roles"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/roles/available'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetAvailableRoles200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.get_available_roles",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#get_available_roles\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get multi-role feature configuration
+    # Get the ready-to-use multi-role system configuration for a project
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @return [GetMultiRoleConfig200Response]
+    def get_multi_role_config(project_id, opts = {})
+      data, _status_code, _headers = get_multi_role_config_with_http_info(project_id, opts)
+      data
+    end
+
+    # Get multi-role feature configuration
+    # Get the ready-to-use multi-role system configuration for a project
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetMultiRoleConfig200Response, Integer, Hash)>] GetMultiRoleConfig200Response data, response status code and response headers
+    def get_multi_role_config_with_http_info(project_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.get_multi_role_config ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.get_multi_role_config"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetMultiRoleConfig200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.get_multi_role_config",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#get_multi_role_config\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # OAuth signup with specific role
+    # Public endpoint that initiates OAuth signup flow with a specific role assigned during registration. The OAuth provider must be configured and enabled for the project first. The role must be available for signup in the project's multi-role configuration. After successful OAuth authentication, the user will be created with the specified role. No authentication required - this is a public signup endpoint. 
+    # @param role [String] Role slug for signup (e.g. customer, vendor, seller).
+    # @param provider [String] OAuth provider (e.g. google, github).
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :redirect_url The URL to redirect to after authentication
+    # @return [LinkOAuthProvider200Response]
+    def oauth_signup_with_role(role, provider, project_id, opts = {})
+      data, _status_code, _headers = oauth_signup_with_role_with_http_info(role, provider, project_id, opts)
+      data
+    end
+
+    # OAuth signup with specific role
+    # Public endpoint that initiates OAuth signup flow with a specific role assigned during registration. The OAuth provider must be configured and enabled for the project first. The role must be available for signup in the project&#39;s multi-role configuration. After successful OAuth authentication, the user will be created with the specified role. No authentication required - this is a public signup endpoint. 
+    # @param role [String] Role slug for signup (e.g. customer, vendor, seller).
+    # @param provider [String] OAuth provider (e.g. google, github).
+    # @param project_id [String] Project ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :redirect_url The URL to redirect to after authentication
+    # @return [Array<(LinkOAuthProvider200Response, Integer, Hash)>] LinkOAuthProvider200Response data, response status code and response headers
+    def oauth_signup_with_role_with_http_info(role, provider, project_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.oauth_signup_with_role ...'
+      end
+      # verify the required parameter 'role' is set
+      if @api_client.config.client_side_validation && role.nil?
+        fail ArgumentError, "Missing the required parameter 'role' when calling MultiRoleFeatureApi.oauth_signup_with_role"
+      end
+      # verify the required parameter 'provider' is set
+      if @api_client.config.client_side_validation && provider.nil?
+        fail ArgumentError, "Missing the required parameter 'provider' when calling MultiRoleFeatureApi.oauth_signup_with_role"
+      end
+      # verify enum value
+      allowable_values = ["google", "github", "facebook", "microsoft", "apple", "twitter", "discord", "linkedin", "dropbox", "slack", "reddit", "twitch", "figma", "zoom", "bitbucket", "salesforce", "shopify", "line", "spotify", "strava", "paypal", "asana", "trello", "okta", "gitea", "yandex", "yahoo", "vk", "meetup"]
+      if @api_client.config.client_side_validation && !allowable_values.include?(provider)
+        fail ArgumentError, "invalid value for \"provider\", must be one of #{allowable_values}"
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.oauth_signup_with_role"
+      end
+      # resource path
+      local_var_path = '/api/auth/oauth/signup/{role}/{provider}/{projectId}'.sub('{' + 'role' + '}', CGI.escape(role.to_s)).sub('{' + 'provider' + '}', CGI.escape(provider.to_s)).sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'redirect_url'] = opts[:'redirect_url'] if !opts[:'redirect_url'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'LinkOAuthProvider200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.oauth_signup_with_role",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#oauth_signup_with_role\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Register user with specific role (Local Auth)
+    # Public endpoint for user registration with a specific role. The role is specified in the URL path (e.g., /signup/customer, /signup/vendor). No authentication required - this is a public signup endpoint. 
+    # @param role [String] Role slug for signup (e.g. customer, vendor).
+    # @param register_with_role_request [RegisterWithRoleRequest] Registration payload (email, password, firstName, lastName, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def register_with_role(role, register_with_role_request, opts = {})
+      register_with_role_with_http_info(role, register_with_role_request, opts)
+      nil
+    end
+
+    # Register user with specific role (Local Auth)
+    # Public endpoint for user registration with a specific role. The role is specified in the URL path (e.g., /signup/customer, /signup/vendor). No authentication required - this is a public signup endpoint. 
+    # @param role [String] Role slug for signup (e.g. customer, vendor).
+    # @param register_with_role_request [RegisterWithRoleRequest] Registration payload (email, password, firstName, lastName, projectId).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def register_with_role_with_http_info(role, register_with_role_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.register_with_role ...'
+      end
+      # verify the required parameter 'role' is set
+      if @api_client.config.client_side_validation && role.nil?
+        fail ArgumentError, "Missing the required parameter 'role' when calling MultiRoleFeatureApi.register_with_role"
+      end
+      # verify the required parameter 'register_with_role_request' is set
+      if @api_client.config.client_side_validation && register_with_role_request.nil?
+        fail ArgumentError, "Missing the required parameter 'register_with_role_request' when calling MultiRoleFeatureApi.register_with_role"
+      end
+      # resource path
+      local_var_path = '/api/auth/local/signup/{role}'.sub('{' + 'role' + '}', CGI.escape(role.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(register_with_role_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.register_with_role",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#register_with_role\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Toggle role on/off
+    # Enable or disable a role for the project. When disabled, the role is no longer available for signup or assignment.
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug to toggle (e.g. vendor, customer).
+    # @param toggle_role_request [ToggleRoleRequest] Whether the role is enabled (true) or disabled (false).
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateMultiRoleSettings200Response]
+    def toggle_role(project_id, role_slug, toggle_role_request, opts = {})
+      data, _status_code, _headers = toggle_role_with_http_info(project_id, role_slug, toggle_role_request, opts)
+      data
+    end
+
+    # Toggle role on/off
+    # Enable or disable a role for the project. When disabled, the role is no longer available for signup or assignment.
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug to toggle (e.g. vendor, customer).
+    # @param toggle_role_request [ToggleRoleRequest] Whether the role is enabled (true) or disabled (false).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateMultiRoleSettings200Response, Integer, Hash)>] UpdateMultiRoleSettings200Response data, response status code and response headers
+    def toggle_role_with_http_info(project_id, role_slug, toggle_role_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.toggle_role ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.toggle_role"
+      end
+      # verify the required parameter 'role_slug' is set
+      if @api_client.config.client_side_validation && role_slug.nil?
+        fail ArgumentError, "Missing the required parameter 'role_slug' when calling MultiRoleFeatureApi.toggle_role"
+      end
+      # verify the required parameter 'toggle_role_request' is set
+      if @api_client.config.client_side_validation && toggle_role_request.nil?
+        fail ArgumentError, "Missing the required parameter 'toggle_role_request' when calling MultiRoleFeatureApi.toggle_role"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/roles/{roleSlug}/toggle'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'roleSlug' + '}', CGI.escape(role_slug.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(toggle_role_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateMultiRoleSettings200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.toggle_role",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#toggle_role\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update collection permissions for a role
+    # Update collection-specific permissions for a role in a project. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug (e.g. vendor, customer).
+    # @param collection_id [String] Collection ID to set permissions for.
+    # @param update_collection_permissions_request [UpdateCollectionPermissionsRequest] Allowed actions and optional conditions for the role on this collection.
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateMultiRoleSettings200Response]
+    def update_collection_permissions(project_id, role_slug, collection_id, update_collection_permissions_request, opts = {})
+      data, _status_code, _headers = update_collection_permissions_with_http_info(project_id, role_slug, collection_id, update_collection_permissions_request, opts)
+      data
+    end
+
+    # Update collection permissions for a role
+    # Update collection-specific permissions for a role in a project. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug (e.g. vendor, customer).
+    # @param collection_id [String] Collection ID to set permissions for.
+    # @param update_collection_permissions_request [UpdateCollectionPermissionsRequest] Allowed actions and optional conditions for the role on this collection.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateMultiRoleSettings200Response, Integer, Hash)>] UpdateMultiRoleSettings200Response data, response status code and response headers
+    def update_collection_permissions_with_http_info(project_id, role_slug, collection_id, update_collection_permissions_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.update_collection_permissions ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.update_collection_permissions"
+      end
+      # verify the required parameter 'role_slug' is set
+      if @api_client.config.client_side_validation && role_slug.nil?
+        fail ArgumentError, "Missing the required parameter 'role_slug' when calling MultiRoleFeatureApi.update_collection_permissions"
+      end
+      # verify the required parameter 'collection_id' is set
+      if @api_client.config.client_side_validation && collection_id.nil?
+        fail ArgumentError, "Missing the required parameter 'collection_id' when calling MultiRoleFeatureApi.update_collection_permissions"
+      end
+      # verify the required parameter 'update_collection_permissions_request' is set
+      if @api_client.config.client_side_validation && update_collection_permissions_request.nil?
+        fail ArgumentError, "Missing the required parameter 'update_collection_permissions_request' when calling MultiRoleFeatureApi.update_collection_permissions"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/roles/{roleSlug}/collections/{collectionId}/permissions'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'roleSlug' + '}', CGI.escape(role_slug.to_s)).sub('{' + 'collectionId' + '}', CGI.escape(collection_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_collection_permissions_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateMultiRoleSettings200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.update_collection_permissions",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#update_collection_permissions\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update multi-role feature settings
+    # Update multi-role feature settings for a project, including enabling/disabling the feature and configuring default roles. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param update_multi_role_settings_request [UpdateMultiRoleSettingsRequest] Multi-role settings (e.g. isEnabled, defaultRole, allowMultipleRoles, requireApproval).
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateMultiRoleSettings200Response]
+    def update_multi_role_settings(project_id, update_multi_role_settings_request, opts = {})
+      data, _status_code, _headers = update_multi_role_settings_with_http_info(project_id, update_multi_role_settings_request, opts)
+      data
+    end
+
+    # Update multi-role feature settings
+    # Update multi-role feature settings for a project, including enabling/disabling the feature and configuring default roles. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param update_multi_role_settings_request [UpdateMultiRoleSettingsRequest] Multi-role settings (e.g. isEnabled, defaultRole, allowMultipleRoles, requireApproval).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateMultiRoleSettings200Response, Integer, Hash)>] UpdateMultiRoleSettings200Response data, response status code and response headers
+    def update_multi_role_settings_with_http_info(project_id, update_multi_role_settings_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.update_multi_role_settings ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.update_multi_role_settings"
+      end
+      # verify the required parameter 'update_multi_role_settings_request' is set
+      if @api_client.config.client_side_validation && update_multi_role_settings_request.nil?
+        fail ArgumentError, "Missing the required parameter 'update_multi_role_settings_request' when calling MultiRoleFeatureApi.update_multi_role_settings"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/settings'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_multi_role_settings_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateMultiRoleSettings200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.update_multi_role_settings",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#update_multi_role_settings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update role configuration
+    # Update an existing role's metadata and requirements (name, description, hierarchy, approval/payment/KYC flags).
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug to update (e.g. vendor, customer).
+    # @param update_project_role_request [UpdateProjectRoleRequest] Role fields to update (name, description, hierarchy, requiresApproval, requiresPayment, requiresKYC).
+    # @param [Hash] opts the optional parameters
+    # @return [UpdateMultiRoleSettings200Response]
+    def update_project_role(project_id, role_slug, update_project_role_request, opts = {})
+      data, _status_code, _headers = update_project_role_with_http_info(project_id, role_slug, update_project_role_request, opts)
+      data
+    end
+
+    # Update role configuration
+    # Update an existing role&#39;s metadata and requirements (name, description, hierarchy, approval/payment/KYC flags).
+    # @param project_id [String] Project ID.
+    # @param role_slug [String] Role slug to update (e.g. vendor, customer).
+    # @param update_project_role_request [UpdateProjectRoleRequest] Role fields to update (name, description, hierarchy, requiresApproval, requiresPayment, requiresKYC).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(UpdateMultiRoleSettings200Response, Integer, Hash)>] UpdateMultiRoleSettings200Response data, response status code and response headers
+    def update_project_role_with_http_info(project_id, role_slug, update_project_role_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: MultiRoleFeatureApi.update_project_role ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling MultiRoleFeatureApi.update_project_role"
+      end
+      # verify the required parameter 'role_slug' is set
+      if @api_client.config.client_side_validation && role_slug.nil?
+        fail ArgumentError, "Missing the required parameter 'role_slug' when calling MultiRoleFeatureApi.update_project_role"
+      end
+      # verify the required parameter 'update_project_role_request' is set
+      if @api_client.config.client_side_validation && update_project_role_request.nil?
+        fail ArgumentError, "Missing the required parameter 'update_project_role_request' when calling MultiRoleFeatureApi.update_project_role"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/multi-role/roles/{roleSlug}'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'roleSlug' + '}', CGI.escape(role_slug.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(update_project_role_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UpdateMultiRoleSettings200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"MultiRoleFeatureApi.update_project_role",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: MultiRoleFeatureApi#update_project_role\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end