mudbase 1.2.9 → 1.2.10

data/docs/MultiRoleApi.md

@@ -6,6 +6,16 @@ All URIs are relative to *https://cloud.mudbase.dev*
 | ------ | ------------ | ----------- |
 | [**auth_oauth_signup_with_role**](MultiRoleApi.md#auth_oauth_signup_with_role) | **GET** /api/auth/oauth/signup/{role}/{provider}/{projectId} | OAuth signup with specific role |
 | [**auth_register_with_role**](MultiRoleApi.md#auth_register_with_role) | **POST** /api/auth/local/signup/{role} | Register user with specific role (Local Auth) |
+| [**multi_role_add_role**](MultiRoleApi.md#multi_role_add_role) | **POST** /api/projects/{projectId}/multi-role/roles | Add custom role |
+| [**multi_role_apply_role_feature_preset**](MultiRoleApi.md#multi_role_apply_role_feature_preset) | **POST** /api/projects/{projectId}/multi-role/roles/{roleSlug}/apply-preset | Apply Admin / User / Viewer feature permission preset |
+| [**multi_role_get_available_roles**](MultiRoleApi.md#multi_role_get_available_roles) | **GET** /api/projects/{projectId}/multi-role/roles/available | Get available roles for signup |
+| [**multi_role_get_config**](MultiRoleApi.md#multi_role_get_config) | **GET** /api/projects/{projectId}/multi-role | Get multi-role feature configuration |
+| [**multi_role_get_permissions_matrix**](MultiRoleApi.md#multi_role_get_permissions_matrix) | **GET** /api/projects/{projectId}/permissions-matrix | Get permissions matrix (collections + featurePermissions) |
+| [**multi_role_simulate_app_permissions**](MultiRoleApi.md#multi_role_simulate_app_permissions) | **POST** /api/projects/{projectId}/multi-role/simulate-permissions | Simulate app-role feature permission for a path |
+| [**multi_role_toggle_role**](MultiRoleApi.md#multi_role_toggle_role) | **PATCH** /api/projects/{projectId}/multi-role/roles/{roleSlug}/toggle | Toggle role on/off |
+| [**multi_role_update_collection_permissions**](MultiRoleApi.md#multi_role_update_collection_permissions) | **PATCH** /api/projects/{projectId}/multi-role/roles/{roleSlug}/collections/{collectionId}/permissions | Update collection permissions for a role |
+| [**multi_role_update_role**](MultiRoleApi.md#multi_role_update_role) | **PATCH** /api/projects/{projectId}/multi-role/roles/{roleSlug} | Update role configuration |
+| [**multi_role_update_settings**](MultiRoleApi.md#multi_role_update_settings) | **PATCH** /api/projects/{projectId}/multi-role/settings | Update multi-role feature settings |
 
 
 ## auth_oauth_signup_with_role
@@ -144,3 +154,716 @@ No authorization required
 - **Content-Type**: application/json
 - **Accept**: application/json
 
+
+## multi_role_add_role
+
+> <MultiRoleToggleRole200Response> multi_role_add_role(project_id, multi_role_add_role_request)
+
+Add custom role
+
+Add a custom role to a project with specific permissions and signup endpoint. Optional **featurePermissions** must align with app JWT gates — see `components/schemas/AppRoleFeaturePermissions` and `services/appRoleFeatureMap.js`. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+multi_role_add_role_request = Mudbase::MultiRoleAddRoleRequest.new({slug: 'seller', name: 'Seller', signup_endpoint: 'seller'}) # MultiRoleAddRoleRequest | Custom role definition. Use `collectionPermissions` to apply CRUD per collection slug (e.g. users/products/orders). `defaultPermissions` is optional for global/base permissions.
+
+begin
+  # Add custom role
+  result = api_instance.multi_role_add_role(project_id, multi_role_add_role_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_add_role: #{e}"
+end
+```
+
+#### Using the multi_role_add_role_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleToggleRole200Response>, Integer, Hash)> multi_role_add_role_with_http_info(project_id, multi_role_add_role_request)
+
+```ruby
+begin
+  # Add custom role
+  data, status_code, headers = api_instance.multi_role_add_role_with_http_info(project_id, multi_role_add_role_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleToggleRole200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_add_role_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **multi_role_add_role_request** | [**MultiRoleAddRoleRequest**](MultiRoleAddRoleRequest.md) | Custom role definition. Use &#x60;collectionPermissions&#x60; to apply CRUD per collection slug (e.g. users/products/orders). &#x60;defaultPermissions&#x60; is optional for global/base permissions. |  |
+
+### Return type
+
+[**MultiRoleToggleRole200Response**](MultiRoleToggleRole200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_apply_role_feature_preset
+
+> multi_role_apply_role_feature_preset(project_id, role_slug, multi_role_apply_role_feature_preset_request)
+
+Apply Admin / User / Viewer feature permission preset
+
+Sets `featurePermissions` from preset `admin`, `user`, or `viewer`.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = 'project_id_example' # String | 
+role_slug = 'role_slug_example' # String | 
+multi_role_apply_role_feature_preset_request = Mudbase::MultiRoleApplyRoleFeaturePresetRequest.new({preset: 'admin'}) # MultiRoleApplyRoleFeaturePresetRequest | 
+
+begin
+  # Apply Admin / User / Viewer feature permission preset
+  api_instance.multi_role_apply_role_feature_preset(project_id, role_slug, multi_role_apply_role_feature_preset_request)
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_apply_role_feature_preset: #{e}"
+end
+```
+
+#### Using the multi_role_apply_role_feature_preset_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> multi_role_apply_role_feature_preset_with_http_info(project_id, role_slug, multi_role_apply_role_feature_preset_request)
+
+```ruby
+begin
+  # Apply Admin / User / Viewer feature permission preset
+  data, status_code, headers = api_instance.multi_role_apply_role_feature_preset_with_http_info(project_id, role_slug, multi_role_apply_role_feature_preset_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_apply_role_feature_preset_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **role_slug** | **String** |  |  |
+| **multi_role_apply_role_feature_preset_request** | [**MultiRoleApplyRoleFeaturePresetRequest**](MultiRoleApplyRoleFeaturePresetRequest.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_get_available_roles
+
+> <MultiRoleGetAvailableRoles200Response> multi_role_get_available_roles(project_id)
+
+Get available roles for signup
+
+Get all available roles for user signup in a project. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+
+begin
+  # Get available roles for signup
+  result = api_instance.multi_role_get_available_roles(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_available_roles: #{e}"
+end
+```
+
+#### Using the multi_role_get_available_roles_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleGetAvailableRoles200Response>, Integer, Hash)> multi_role_get_available_roles_with_http_info(project_id)
+
+```ruby
+begin
+  # Get available roles for signup
+  data, status_code, headers = api_instance.multi_role_get_available_roles_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleGetAvailableRoles200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_available_roles_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+
+### Return type
+
+[**MultiRoleGetAvailableRoles200Response**](MultiRoleGetAvailableRoles200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## multi_role_get_config
+
+> <MultiRoleGetConfig200Response> multi_role_get_config(project_id)
+
+Get multi-role feature configuration
+
+Returns project app roles (default one editable `customer` starter until you add more) and settings.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+
+begin
+  # Get multi-role feature configuration
+  result = api_instance.multi_role_get_config(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_config: #{e}"
+end
+```
+
+#### Using the multi_role_get_config_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleGetConfig200Response>, Integer, Hash)> multi_role_get_config_with_http_info(project_id)
+
+```ruby
+begin
+  # Get multi-role feature configuration
+  data, status_code, headers = api_instance.multi_role_get_config_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleGetConfig200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_config_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+
+### Return type
+
+[**MultiRoleGetConfig200Response**](MultiRoleGetConfig200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## multi_role_get_permissions_matrix
+
+> <MultiRoleGetPermissionsMatrix200Response> multi_role_get_permissions_matrix(project_id)
+
+Get permissions matrix (collections + featurePermissions)
+
+Per-collection role actions and per-role `featurePermissions` for app-role gates.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | 
+
+begin
+  # Get permissions matrix (collections + featurePermissions)
+  result = api_instance.multi_role_get_permissions_matrix(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_permissions_matrix: #{e}"
+end
+```
+
+#### Using the multi_role_get_permissions_matrix_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleGetPermissionsMatrix200Response>, Integer, Hash)> multi_role_get_permissions_matrix_with_http_info(project_id)
+
+```ruby
+begin
+  # Get permissions matrix (collections + featurePermissions)
+  data, status_code, headers = api_instance.multi_role_get_permissions_matrix_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleGetPermissionsMatrix200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_get_permissions_matrix_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**MultiRoleGetPermissionsMatrix200Response**](MultiRoleGetPermissionsMatrix200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## multi_role_simulate_app_permissions
+
+> Object multi_role_simulate_app_permissions(project_id, multi_role_simulate_app_permissions_request)
+
+Simulate app-role feature permission for a path
+
+Given role slug and either `operationId` or HTTP method + pathname, returns whether `featurePermissions` would allow gated routes. Unmapped paths or unknown operation IDs return allowed with `no_feature_gate_for_path` or `no_feature_gate_for_operation_id`.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = 'project_id_example' # String | 
+multi_role_simulate_app_permissions_request = Mudbase::MultiRoleSimulateAppPermissionsRequest.new({role: 'role_example'}) # MultiRoleSimulateAppPermissionsRequest | 
+
+begin
+  # Simulate app-role feature permission for a path
+  result = api_instance.multi_role_simulate_app_permissions(project_id, multi_role_simulate_app_permissions_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_simulate_app_permissions: #{e}"
+end
+```
+
+#### Using the multi_role_simulate_app_permissions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(Object, Integer, Hash)> multi_role_simulate_app_permissions_with_http_info(project_id, multi_role_simulate_app_permissions_request)
+
+```ruby
+begin
+  # Simulate app-role feature permission for a path
+  data, status_code, headers = api_instance.multi_role_simulate_app_permissions_with_http_info(project_id, multi_role_simulate_app_permissions_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => Object
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_simulate_app_permissions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **multi_role_simulate_app_permissions_request** | [**MultiRoleSimulateAppPermissionsRequest**](MultiRoleSimulateAppPermissionsRequest.md) |  |  |
+
+### Return type
+
+**Object**
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_toggle_role
+
+> <MultiRoleToggleRole200Response> multi_role_toggle_role(project_id, role_slug, multi_role_toggle_role_request)
+
+Toggle role on/off
+
+Enable or disable a role for the project. When disabled, the role is no longer available for signup or assignment.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+role_slug = 'customer' # String | Role slug to toggle (e.g. starter `customer` or a role you added).
+multi_role_toggle_role_request = Mudbase::MultiRoleToggleRoleRequest.new({is_enabled: true}) # MultiRoleToggleRoleRequest | Whether the role is enabled (true) or disabled (false).
+
+begin
+  # Toggle role on/off
+  result = api_instance.multi_role_toggle_role(project_id, role_slug, multi_role_toggle_role_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_toggle_role: #{e}"
+end
+```
+
+#### Using the multi_role_toggle_role_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleToggleRole200Response>, Integer, Hash)> multi_role_toggle_role_with_http_info(project_id, role_slug, multi_role_toggle_role_request)
+
+```ruby
+begin
+  # Toggle role on/off
+  data, status_code, headers = api_instance.multi_role_toggle_role_with_http_info(project_id, role_slug, multi_role_toggle_role_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleToggleRole200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_toggle_role_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **role_slug** | **String** | Role slug to toggle (e.g. starter &#x60;customer&#x60; or a role you added). |  |
+| **multi_role_toggle_role_request** | [**MultiRoleToggleRoleRequest**](MultiRoleToggleRoleRequest.md) | Whether the role is enabled (true) or disabled (false). |  |
+
+### Return type
+
+[**MultiRoleToggleRole200Response**](MultiRoleToggleRole200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_update_collection_permissions
+
+> <MultiRoleToggleRole200Response> multi_role_update_collection_permissions(project_id, role_slug, collection_id, multi_role_update_collection_permissions_request)
+
+Update collection permissions for a role
+
+Update collection-specific permissions for a role in a project. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+role_slug = 'customer' # String | Role slug (e.g. starter `customer` or a role you added).
+collection_id = '696ba6e4f4a9422ac4be4f74' # String | Collection ID to set permissions for.
+multi_role_update_collection_permissions_request = Mudbase::MultiRoleUpdateCollectionPermissionsRequest.new # MultiRoleUpdateCollectionPermissionsRequest | Allowed actions and optional conditions for the role on this collection.
+
+begin
+  # Update collection permissions for a role
+  result = api_instance.multi_role_update_collection_permissions(project_id, role_slug, collection_id, multi_role_update_collection_permissions_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_collection_permissions: #{e}"
+end
+```
+
+#### Using the multi_role_update_collection_permissions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleToggleRole200Response>, Integer, Hash)> multi_role_update_collection_permissions_with_http_info(project_id, role_slug, collection_id, multi_role_update_collection_permissions_request)
+
+```ruby
+begin
+  # Update collection permissions for a role
+  data, status_code, headers = api_instance.multi_role_update_collection_permissions_with_http_info(project_id, role_slug, collection_id, multi_role_update_collection_permissions_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleToggleRole200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_collection_permissions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **role_slug** | **String** | Role slug (e.g. starter &#x60;customer&#x60; or a role you added). |  |
+| **collection_id** | **String** | Collection ID to set permissions for. |  |
+| **multi_role_update_collection_permissions_request** | [**MultiRoleUpdateCollectionPermissionsRequest**](MultiRoleUpdateCollectionPermissionsRequest.md) | Allowed actions and optional conditions for the role on this collection. |  |
+
+### Return type
+
+[**MultiRoleToggleRole200Response**](MultiRoleToggleRole200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_update_role
+
+> <MultiRoleToggleRole200Response> multi_role_update_role(project_id, role_slug, multi_role_update_role_request)
+
+Update role configuration
+
+Update an app role — same fields as **Add custom role** (partial). `defaultPermissions` / `collectionPermissions` use the same normalization as on create. **featurePermissions:** `components/schemas/AppRoleFeaturePermissions` (see `services/appRoleFeatureMap.js`).
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+role_slug = 'customer' # String | Role slug to update (e.g. starter `customer` or a role you added).
+multi_role_update_role_request = Mudbase::MultiRoleUpdateRoleRequest.new # MultiRoleUpdateRoleRequest | Same fields as **Add custom role** — send only fields you want to change. `defaultPermissions` / `collectionPermissions` are normalized the same way as on create.
+
+begin
+  # Update role configuration
+  result = api_instance.multi_role_update_role(project_id, role_slug, multi_role_update_role_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_role: #{e}"
+end
+```
+
+#### Using the multi_role_update_role_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleToggleRole200Response>, Integer, Hash)> multi_role_update_role_with_http_info(project_id, role_slug, multi_role_update_role_request)
+
+```ruby
+begin
+  # Update role configuration
+  data, status_code, headers = api_instance.multi_role_update_role_with_http_info(project_id, role_slug, multi_role_update_role_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleToggleRole200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_role_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **role_slug** | **String** | Role slug to update (e.g. starter &#x60;customer&#x60; or a role you added). |  |
+| **multi_role_update_role_request** | [**MultiRoleUpdateRoleRequest**](MultiRoleUpdateRoleRequest.md) | Same fields as **Add custom role** — send only fields you want to change. &#x60;defaultPermissions&#x60; / &#x60;collectionPermissions&#x60; are normalized the same way as on create. |  |
+
+### Return type
+
+[**MultiRoleToggleRole200Response**](MultiRoleToggleRole200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## multi_role_update_settings
+
+> <MultiRoleUpdateSettings200Response> multi_role_update_settings(project_id, multi_role_update_settings_request)
+
+Update multi-role feature settings
+
+Update multi-role feature settings: enable/disable the feature, `defaultRole`, and `settings` (`allowMultipleRoles`, `requireRoleSelection`, `autoAssignDefault`, `dataOwnerField`). Does not edit role definitions — use `POST/PATCH .../multi-role/roles` (same body shape as add role). Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): BearerToken
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::MultiRoleApi.new
+project_id = '685ad30be129932fbb7a1047' # String | Project ID.
+multi_role_update_settings_request = Mudbase::MultiRoleUpdateSettingsRequest.new # MultiRoleUpdateSettingsRequest | Feature flags only — not per-role approval. Use `settings.allowMultipleRoles`, `requireRoleSelection`, `autoAssignDefault`, `dataOwnerField`.
+
+begin
+  # Update multi-role feature settings
+  result = api_instance.multi_role_update_settings(project_id, multi_role_update_settings_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_settings: #{e}"
+end
+```
+
+#### Using the multi_role_update_settings_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MultiRoleUpdateSettings200Response>, Integer, Hash)> multi_role_update_settings_with_http_info(project_id, multi_role_update_settings_request)
+
+```ruby
+begin
+  # Update multi-role feature settings
+  data, status_code, headers = api_instance.multi_role_update_settings_with_http_info(project_id, multi_role_update_settings_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MultiRoleUpdateSettings200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling MultiRoleApi->multi_role_update_settings_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** | Project ID. |  |
+| **multi_role_update_settings_request** | [**MultiRoleUpdateSettingsRequest**](MultiRoleUpdateSettingsRequest.md) | Feature flags only — not per-role approval. Use &#x60;settings.allowMultipleRoles&#x60;, &#x60;requireRoleSelection&#x60;, &#x60;autoAssignDefault&#x60;, &#x60;dataOwnerField&#x60;. |  |
+
+### Return type
+
+[**MultiRoleUpdateSettings200Response**](MultiRoleUpdateSettings200Response.md)
+
+### Authorization
+
+[BearerToken](../README.md#BearerToken)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+