mudbase 1.2.12 → 1.3.0

data/docs/UsersApi.md

@@ -4,28 +4,95 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**users_change_password**](UsersApi.md#users_change_password) | **PATCH** /api/users/password | Change password |
-| [**users_disable2fa**](UsersApi.md#users_disable2fa) | **POST** /api/users/2fa/disable | Disable 2FA |
-| [**users_erase_data**](UsersApi.md#users_erase_data) | **POST** /api/users/me/erase | Delete user data (GDPR Article 17) |
-| [**users_export_data**](UsersApi.md#users_export_data) | **GET** /api/users/me/export | Export user data (GDPR Article 15) |
-| [**users_get**](UsersApi.md#users_get) | **GET** /api/users/me | Get current user profile |
-| [**users_link_o_auth_provider**](UsersApi.md#users_link_o_auth_provider) | **GET** /api/users/me/oauth-providers/link/{provider} | Link OAuth provider to account |
-| [**users_list_o_auth_providers**](UsersApi.md#users_list_o_auth_providers) | **GET** /api/users/me/oauth-providers | List linked OAuth providers |
-| [**users_resend_verification**](UsersApi.md#users_resend_verification) | **POST** /api/users/resend-verification | Resend verification email |
-| [**users_setup2fa**](UsersApi.md#users_setup2fa) | **POST** /api/users/2fa/setup | Initiate two-factor authentication setup (secret, QR code, backup codes) |
-| [**users_unlink_o_auth_provider**](UsersApi.md#users_unlink_o_auth_provider) | **DELETE** /api/users/me/oauth-providers/{provider} | Unlink OAuth provider |
-| [**users_update**](UsersApi.md#users_update) | **PATCH** /api/users/update | Update user profile |
-| [**users_verify2fa**](UsersApi.md#users_verify2fa) | **POST** /api/users/2fa/verify | Verify and enable 2FA |
-| [**users_verify_email**](UsersApi.md#users_verify_email) | **POST** /api/users/verify-email | Verify email address (with optional project context) |
+| [**api_me_bootstrap_get**](UsersApi.md#api_me_bootstrap_get) | **GET** /api/me/bootstrap | Dashboard bootstrap (session + orgs + default org + projects) |
+| [**change_password**](UsersApi.md#change_password) | **PATCH** /api/users/password | Change password |
+| [**disable2_fa**](UsersApi.md#disable2_fa) | **POST** /api/users/2fa/disable | Disable 2FA |
+| [**erase_user_data**](UsersApi.md#erase_user_data) | **POST** /api/users/me/erase | Delete user data (GDPR Article 17) |
+| [**export_user_data**](UsersApi.md#export_user_data) | **GET** /api/users/me/export | Export user data (GDPR Article 15) |
+| [**get_current_user**](UsersApi.md#get_current_user) | **GET** /api/users/me | Get current user profile |
+| [**link_o_auth_provider**](UsersApi.md#link_o_auth_provider) | **GET** /api/users/me/oauth-providers/link/{provider} | Link OAuth provider to account |
+| [**list_o_auth_providers**](UsersApi.md#list_o_auth_providers) | **GET** /api/users/me/oauth-providers | List linked OAuth providers |
+| [**resend_verification_email**](UsersApi.md#resend_verification_email) | **POST** /api/users/resend-verification | Resend verification email |
+| [**setup2_fa**](UsersApi.md#setup2_fa) | **POST** /api/users/2fa/setup | Setup 2FA |
+| [**unlink_o_auth_provider**](UsersApi.md#unlink_o_auth_provider) | **DELETE** /api/users/me/oauth-providers/{provider} | Unlink OAuth provider |
+| [**update_user_profile**](UsersApi.md#update_user_profile) | **PATCH** /api/users/update | Update user profile |
+| [**verify2_fa**](UsersApi.md#verify2_fa) | **POST** /api/users/2fa/verify | Verify and enable 2FA |
+| [**verify_email**](UsersApi.md#verify_email) | **POST** /api/users/verify-email | Verify email address (organization and project) |
 
 
-## users_change_password
+## api_me_bootstrap_get
 
-> <MessageResponse> users_change_password(change_password_request)
+> <ApiMeBootstrapGet200Response> api_me_bootstrap_get
+
+Dashboard bootstrap (session + orgs + default org + projects)
+
+Consolidated dashboard warmup in a single round-trip. Returns the session user, the user's organizations, the resolved default organization, and that org's projects. Shapes match GET /api/auth/session, GET /api/orgs and GET /api/projects.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::UsersApi.new
+
+begin
+  # Dashboard bootstrap (session + orgs + default org + projects)
+  result = api_instance.api_me_bootstrap_get
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling UsersApi->api_me_bootstrap_get: #{e}"
+end
+```
+
+#### Using the api_me_bootstrap_get_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<ApiMeBootstrapGet200Response>, Integer, Hash)> api_me_bootstrap_get_with_http_info
+
+```ruby
+begin
+  # Dashboard bootstrap (session + orgs + default org + projects)
+  data, status_code, headers = api_instance.api_me_bootstrap_get_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <ApiMeBootstrapGet200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling UsersApi->api_me_bootstrap_get_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**ApiMeBootstrapGet200Response**](ApiMeBootstrapGet200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## change_password
+
+> <MessageResponse> change_password(change_password_request)
 
 Change password
 
-Change the current user's password. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Change the current user's password. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -34,37 +101,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-change_password_request = Mudbase::ChangePasswordRequest.new({current_password: 'current_password_example', new_password: 'new_password_example'}) # ChangePasswordRequest | Current password and new password.
+change_password_request = Mudbase::ChangePasswordRequest.new({current_password: 'current_password_example', new_password: 'new_password_example'}) # ChangePasswordRequest | 
 
 begin
   # Change password
-  result = api_instance.users_change_password(change_password_request)
+  result = api_instance.change_password(change_password_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_change_password: #{e}"
+  puts "Error when calling UsersApi->change_password: #{e}"
 end
 ```
 
-#### Using the users_change_password_with_http_info variant
+#### Using the change_password_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> users_change_password_with_http_info(change_password_request)
+> <Array(<MessageResponse>, Integer, Hash)> change_password_with_http_info(change_password_request)
 
 ```ruby
 begin
   # Change password
-  data, status_code, headers = api_instance.users_change_password_with_http_info(change_password_request)
+  data, status_code, headers = api_instance.change_password_with_http_info(change_password_request)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_change_password_with_http_info: #{e}"
+  puts "Error when calling UsersApi->change_password_with_http_info: #{e}"
 end
 ```
 
@@ -72,7 +142,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **change_password_request** | [**ChangePasswordRequest**](ChangePasswordRequest.md) | Current password and new password. |  |
+| **change_password_request** | [**ChangePasswordRequest**](ChangePasswordRequest.md) |  |  |
 
 ### Return type
 
@@ -80,7 +150,7 @@ end
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -88,13 +158,13 @@ end
 - **Accept**: application/json
 
 
-## users_disable2fa
+## disable2_fa
 
-> <MessageResponse> users_disable2fa(users_disable2fa_request)
+> <MessageResponse> disable2_fa(disable2_fa_request)
 
 Disable 2FA
 
-Disable two-factor authentication for the current user. Requires JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Disable two-factor authentication for the current user. Requires JWT Bearer token authentication. Both OrgBearerAuth and ProjectBearerAuth are supported (they use the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -103,37 +173,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-users_disable2fa_request = Mudbase::UsersDisable2faRequest.new({password: 'SecurePass123!', token: '123456'}) # UsersDisable2faRequest | Current password and one-time code to confirm disable.
+disable2_fa_request = Mudbase::Disable2FARequest.new({password: 'SecurePass123!', token: '123456'}) # Disable2FARequest | 
 
 begin
   # Disable 2FA
-  result = api_instance.users_disable2fa(users_disable2fa_request)
+  result = api_instance.disable2_fa(disable2_fa_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_disable2fa: #{e}"
+  puts "Error when calling UsersApi->disable2_fa: #{e}"
 end
 ```
 
-#### Using the users_disable2fa_with_http_info variant
+#### Using the disable2_fa_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> users_disable2fa_with_http_info(users_disable2fa_request)
+> <Array(<MessageResponse>, Integer, Hash)> disable2_fa_with_http_info(disable2_fa_request)
 
 ```ruby
 begin
   # Disable 2FA
-  data, status_code, headers = api_instance.users_disable2fa_with_http_info(users_disable2fa_request)
+  data, status_code, headers = api_instance.disable2_fa_with_http_info(disable2_fa_request)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_disable2fa_with_http_info: #{e}"
+  puts "Error when calling UsersApi->disable2_fa_with_http_info: #{e}"
 end
 ```
 
@@ -141,7 +214,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **users_disable2fa_request** | [**UsersDisable2faRequest**](UsersDisable2faRequest.md) | Current password and one-time code to confirm disable. |  |
+| **disable2_fa_request** | [**Disable2FARequest**](Disable2FARequest.md) |  |  |
 
 ### Return type
 
@@ -149,7 +222,7 @@ end
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -157,13 +230,13 @@ end
 - **Accept**: application/json
 
 
-## users_erase_data
+## erase_user_data
 
-> <UsersEraseData200Response> users_erase_data(users_erase_data_request)
+> <EraseUserData200Response> erase_user_data(erase_user_data_request)
 
 Delete user data (GDPR Article 17)
 
-Request account erasure (right to be forgotten). Anonymizes PII and deactivates account with 7-day grace period. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Request account erasure (right to be forgotten). Anonymizes PII, revokes all sessions and API keys, and disables the account immediately (not a grace period - the effect is immediate and irreversible). Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint.  Requires re-proving your current password (skipped only for OAuth-only accounts with no password set) and, if 2FA is enabled, a fresh TOTP code - the same step-up re-authentication already required by the less-destructive `PATCH /api/users/password` and `POST /api/users/2fa/disable`. 
 
 ### Examples
 
@@ -172,37 +245,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-users_erase_data_request = Mudbase::UsersEraseDataRequest.new({confirmation: 'DELETE_MY_ACCOUNT'}) # UsersEraseDataRequest | Confirmation string (DELETE_MY_ACCOUNT) and optional reason for erasure.
+erase_user_data_request = Mudbase::EraseUserDataRequest.new({confirm: 'DELETE'}) # EraseUserDataRequest | 
 
 begin
   # Delete user data (GDPR Article 17)
-  result = api_instance.users_erase_data(users_erase_data_request)
+  result = api_instance.erase_user_data(erase_user_data_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_erase_data: #{e}"
+  puts "Error when calling UsersApi->erase_user_data: #{e}"
 end
 ```
 
-#### Using the users_erase_data_with_http_info variant
+#### Using the erase_user_data_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersEraseData200Response>, Integer, Hash)> users_erase_data_with_http_info(users_erase_data_request)
+> <Array(<EraseUserData200Response>, Integer, Hash)> erase_user_data_with_http_info(erase_user_data_request)
 
 ```ruby
 begin
   # Delete user data (GDPR Article 17)
-  data, status_code, headers = api_instance.users_erase_data_with_http_info(users_erase_data_request)
+  data, status_code, headers = api_instance.erase_user_data_with_http_info(erase_user_data_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersEraseData200Response>
+  p data # => <EraseUserData200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_erase_data_with_http_info: #{e}"
+  puts "Error when calling UsersApi->erase_user_data_with_http_info: #{e}"
 end
 ```
 
@@ -210,15 +286,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **users_erase_data_request** | [**UsersEraseDataRequest**](UsersEraseDataRequest.md) | Confirmation string (DELETE_MY_ACCOUNT) and optional reason for erasure. |  |
+| **erase_user_data_request** | [**EraseUserDataRequest**](EraseUserDataRequest.md) |  |  |
 
 ### Return type
 
-[**UsersEraseData200Response**](UsersEraseData200Response.md)
+[**EraseUserData200Response**](EraseUserData200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -226,13 +302,13 @@ end
 - **Accept**: application/json
 
 
-## users_export_data
+## export_user_data
 
-> <UsersExportData200Response> users_export_data
+> <ExportUserData200Response> export_user_data
 
 Export user data (GDPR Article 15)
 
-Export all user data in JSON format for GDPR data portability compliance. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Export all user data in JSON format for GDPR data portability compliance. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -241,7 +317,10 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
@@ -249,28 +328,28 @@ api_instance = Mudbase::UsersApi.new
 
 begin
   # Export user data (GDPR Article 15)
-  result = api_instance.users_export_data
+  result = api_instance.export_user_data
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_export_data: #{e}"
+  puts "Error when calling UsersApi->export_user_data: #{e}"
 end
 ```
 
-#### Using the users_export_data_with_http_info variant
+#### Using the export_user_data_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersExportData200Response>, Integer, Hash)> users_export_data_with_http_info
+> <Array(<ExportUserData200Response>, Integer, Hash)> export_user_data_with_http_info
 
 ```ruby
 begin
   # Export user data (GDPR Article 15)
-  data, status_code, headers = api_instance.users_export_data_with_http_info
+  data, status_code, headers = api_instance.export_user_data_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersExportData200Response>
+  p data # => <ExportUserData200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_export_data_with_http_info: #{e}"
+  puts "Error when calling UsersApi->export_user_data_with_http_info: #{e}"
 end
 ```
 
@@ -280,11 +359,11 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**UsersExportData200Response**](UsersExportData200Response.md)
+[**ExportUserData200Response**](ExportUserData200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -292,13 +371,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## users_get
+## get_current_user
 
-> <UsersGet200Response> users_get
+> <GetCurrentUser200Response> get_current_user
 
 Get current user profile
 
-Get the current authenticated user's profile. Accepts JWT Bearer token (BearerToken). 
+Get the current authenticated user's profile. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). 
 
 ### Examples
 
@@ -307,7 +386,10 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
@@ -315,28 +397,28 @@ api_instance = Mudbase::UsersApi.new
 
 begin
   # Get current user profile
-  result = api_instance.users_get
+  result = api_instance.get_current_user
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_get: #{e}"
+  puts "Error when calling UsersApi->get_current_user: #{e}"
 end
 ```
 
-#### Using the users_get_with_http_info variant
+#### Using the get_current_user_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersGet200Response>, Integer, Hash)> users_get_with_http_info
+> <Array(<GetCurrentUser200Response>, Integer, Hash)> get_current_user_with_http_info
 
 ```ruby
 begin
   # Get current user profile
-  data, status_code, headers = api_instance.users_get_with_http_info
+  data, status_code, headers = api_instance.get_current_user_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersGet200Response>
+  p data # => <GetCurrentUser200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_get_with_http_info: #{e}"
+  puts "Error when calling UsersApi->get_current_user_with_http_info: #{e}"
 end
 ```
 
@@ -346,11 +428,11 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**UsersGet200Response**](UsersGet200Response.md)
+[**GetCurrentUser200Response**](GetCurrentUser200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -358,13 +440,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## users_link_o_auth_provider
+## link_o_auth_provider
 
-> <UsersLinkOAuthProvider200Response> users_link_o_auth_provider(provider, opts)
+> link_o_auth_provider(provider, opts)
 
 Link OAuth provider to account
 
-Initiate OAuth flow to link a new provider to the current account. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Initiate OAuth flow to link a new provider to the current account. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -373,40 +455,42 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-provider = 'google' # String | OAuth provider to link (e.g. google, github).
+provider = 'google' # String | 
 opts = {
-  project_id: '685ad30be129932fbb7a1047' # String | Project ID for the OAuth link context.
+  project_id: '685ad30be129932fbb7a1047' # String | 
 }
 
 begin
   # Link OAuth provider to account
-  result = api_instance.users_link_o_auth_provider(provider, opts)
-  p result
+  api_instance.link_o_auth_provider(provider, opts)
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_link_o_auth_provider: #{e}"
+  puts "Error when calling UsersApi->link_o_auth_provider: #{e}"
 end
 ```
 
-#### Using the users_link_o_auth_provider_with_http_info variant
+#### Using the link_o_auth_provider_with_http_info variant
 
-This returns an Array which contains the response data, status code and headers.
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(<UsersLinkOAuthProvider200Response>, Integer, Hash)> users_link_o_auth_provider_with_http_info(provider, opts)
+> <Array(nil, Integer, Hash)> link_o_auth_provider_with_http_info(provider, opts)
 
 ```ruby
 begin
   # Link OAuth provider to account
-  data, status_code, headers = api_instance.users_link_o_auth_provider_with_http_info(provider, opts)
+  data, status_code, headers = api_instance.link_o_auth_provider_with_http_info(provider, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersLinkOAuthProvider200Response>
+  p data # => nil
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_link_o_auth_provider_with_http_info: #{e}"
+  puts "Error when calling UsersApi->link_o_auth_provider_with_http_info: #{e}"
 end
 ```
 
@@ -414,16 +498,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **provider** | **String** | OAuth provider to link (e.g. google, github). |  |
-| **project_id** | **String** | Project ID for the OAuth link context. | [optional] |
+| **provider** | **String** |  |  |
+| **project_id** | **String** |  | [optional] |
 
 ### Return type
 
-[**UsersLinkOAuthProvider200Response**](UsersLinkOAuthProvider200Response.md)
+nil (empty response body)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -431,13 +515,13 @@ end
 - **Accept**: application/json
 
 
-## users_list_o_auth_providers
+## list_o_auth_providers
 
-> <UsersListOAuthProviders200Response> users_list_o_auth_providers
+> <ListOAuthProviders200Response> list_o_auth_providers
 
 List linked OAuth providers
 
-Get all OAuth providers linked to the current user's account. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Get all OAuth providers linked to the current user's account. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -446,7 +530,10 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
@@ -454,28 +541,28 @@ api_instance = Mudbase::UsersApi.new
 
 begin
   # List linked OAuth providers
-  result = api_instance.users_list_o_auth_providers
+  result = api_instance.list_o_auth_providers
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_list_o_auth_providers: #{e}"
+  puts "Error when calling UsersApi->list_o_auth_providers: #{e}"
 end
 ```
 
-#### Using the users_list_o_auth_providers_with_http_info variant
+#### Using the list_o_auth_providers_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersListOAuthProviders200Response>, Integer, Hash)> users_list_o_auth_providers_with_http_info
+> <Array(<ListOAuthProviders200Response>, Integer, Hash)> list_o_auth_providers_with_http_info
 
 ```ruby
 begin
   # List linked OAuth providers
-  data, status_code, headers = api_instance.users_list_o_auth_providers_with_http_info
+  data, status_code, headers = api_instance.list_o_auth_providers_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersListOAuthProviders200Response>
+  p data # => <ListOAuthProviders200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_list_o_auth_providers_with_http_info: #{e}"
+  puts "Error when calling UsersApi->list_o_auth_providers_with_http_info: #{e}"
 end
 ```
 
@@ -485,11 +572,11 @@ This endpoint does not need any parameter.
 
 ### Return type
 
-[**UsersListOAuthProviders200Response**](UsersListOAuthProviders200Response.md)
+[**ListOAuthProviders200Response**](ListOAuthProviders200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -497,13 +584,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## users_resend_verification
+## resend_verification_email
 
-> <MessageResponse> users_resend_verification
+> <MessageResponse> resend_verification_email
 
 Resend verification email
 
-Sends a new verification email to the authenticated user. Rate limited (e.g. 3 requests per 15 minutes per user). For app users the link includes project context. 
+Sends a new verification email to the authenticated user. Rate limited (e.g. 3 requests per 15 minutes per user). For project-scoped users the link includes project context. 
 
 ### Examples
 
@@ -512,7 +599,10 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
@@ -520,28 +610,28 @@ api_instance = Mudbase::UsersApi.new
 
 begin
   # Resend verification email
-  result = api_instance.users_resend_verification
+  result = api_instance.resend_verification_email
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_resend_verification: #{e}"
+  puts "Error when calling UsersApi->resend_verification_email: #{e}"
 end
 ```
 
-#### Using the users_resend_verification_with_http_info variant
+#### Using the resend_verification_email_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> users_resend_verification_with_http_info
+> <Array(<MessageResponse>, Integer, Hash)> resend_verification_email_with_http_info
 
 ```ruby
 begin
   # Resend verification email
-  data, status_code, headers = api_instance.users_resend_verification_with_http_info
+  data, status_code, headers = api_instance.resend_verification_email_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_resend_verification_with_http_info: #{e}"
+  puts "Error when calling UsersApi->resend_verification_email_with_http_info: #{e}"
 end
 ```
 
@@ -555,7 +645,7 @@ This endpoint does not need any parameter.
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -563,13 +653,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## users_setup2fa
+## setup2_fa
 
-> <TwoFASetupResponse> users_setup2fa
+> <TwoFASetupResponse> setup2_fa
 
-Initiate two-factor authentication setup (secret, QR code, backup codes)
+Setup 2FA
 
-Initiates two-factor authentication setup for the current user. Returns a secret, QR code, and manual entry key for the user to add to an authenticator app. Requires JWT Bearer token (BearerToken). API keys are not supported. 
+Setup two-factor authentication for the current user. Requires JWT Bearer token authentication. Both OrgBearerAuth and ProjectBearerAuth are supported (they use the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -578,36 +668,39 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
 
 begin
-  # Initiate two-factor authentication setup (secret, QR code, backup codes)
-  result = api_instance.users_setup2fa
+  # Setup 2FA
+  result = api_instance.setup2_fa
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_setup2fa: #{e}"
+  puts "Error when calling UsersApi->setup2_fa: #{e}"
 end
 ```
 
-#### Using the users_setup2fa_with_http_info variant
+#### Using the setup2_fa_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<TwoFASetupResponse>, Integer, Hash)> users_setup2fa_with_http_info
+> <Array(<TwoFASetupResponse>, Integer, Hash)> setup2_fa_with_http_info
 
 ```ruby
 begin
-  # Initiate two-factor authentication setup (secret, QR code, backup codes)
-  data, status_code, headers = api_instance.users_setup2fa_with_http_info
+  # Setup 2FA
+  data, status_code, headers = api_instance.setup2_fa_with_http_info
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <TwoFASetupResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_setup2fa_with_http_info: #{e}"
+  puts "Error when calling UsersApi->setup2_fa_with_http_info: #{e}"
 end
 ```
 
@@ -621,7 +714,7 @@ This endpoint does not need any parameter.
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -629,13 +722,13 @@ This endpoint does not need any parameter.
 - **Accept**: application/json
 
 
-## users_unlink_o_auth_provider
+## unlink_o_auth_provider
 
-> <UsersUnlinkOAuthProvider200Response> users_unlink_o_auth_provider(provider)
+> <UnlinkOAuthProvider200Response> unlink_o_auth_provider(provider)
 
 Unlink OAuth provider
 
-Remove an OAuth provider from the current account. Cannot unlink if it's the only authentication method. Requires JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Remove an OAuth provider from the current account. Cannot unlink if it's the only authentication method. Requires JWT Bearer token authentication. Both OrgBearerAuth and ProjectBearerAuth are supported (they use the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -644,37 +737,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-provider = 'google' # String | OAuth provider to unlink (e.g. google, github).
+provider = 'google' # String | 
 
 begin
   # Unlink OAuth provider
-  result = api_instance.users_unlink_o_auth_provider(provider)
+  result = api_instance.unlink_o_auth_provider(provider)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_unlink_o_auth_provider: #{e}"
+  puts "Error when calling UsersApi->unlink_o_auth_provider: #{e}"
 end
 ```
 
-#### Using the users_unlink_o_auth_provider_with_http_info variant
+#### Using the unlink_o_auth_provider_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersUnlinkOAuthProvider200Response>, Integer, Hash)> users_unlink_o_auth_provider_with_http_info(provider)
+> <Array(<UnlinkOAuthProvider200Response>, Integer, Hash)> unlink_o_auth_provider_with_http_info(provider)
 
 ```ruby
 begin
   # Unlink OAuth provider
-  data, status_code, headers = api_instance.users_unlink_o_auth_provider_with_http_info(provider)
+  data, status_code, headers = api_instance.unlink_o_auth_provider_with_http_info(provider)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersUnlinkOAuthProvider200Response>
+  p data # => <UnlinkOAuthProvider200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_unlink_o_auth_provider_with_http_info: #{e}"
+  puts "Error when calling UsersApi->unlink_o_auth_provider_with_http_info: #{e}"
 end
 ```
 
@@ -682,15 +778,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **provider** | **String** | OAuth provider to unlink (e.g. google, github). |  |
+| **provider** | **String** |  |  |
 
 ### Return type
 
-[**UsersUnlinkOAuthProvider200Response**](UsersUnlinkOAuthProvider200Response.md)
+[**UnlinkOAuthProvider200Response**](UnlinkOAuthProvider200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -698,13 +794,13 @@ end
 - **Accept**: application/json
 
 
-## users_update
+## update_user_profile
 
-> <UsersUpdate200Response> users_update(update_user_request)
+> <UpdateUserProfile200Response> update_user_profile(update_user_request)
 
 Update user profile
 
-Update the current user's profile. Requires JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Update the current user's profile. Requires JWT Bearer token authentication. Both OrgBearerAuth and ProjectBearerAuth are supported (they use the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -713,37 +809,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-update_user_request = Mudbase::UpdateUserRequest.new # UpdateUserRequest | Profile fields to update (firstName, lastName, avatar).
+update_user_request = Mudbase::UpdateUserRequest.new # UpdateUserRequest | 
 
 begin
   # Update user profile
-  result = api_instance.users_update(update_user_request)
+  result = api_instance.update_user_profile(update_user_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_update: #{e}"
+  puts "Error when calling UsersApi->update_user_profile: #{e}"
 end
 ```
 
-#### Using the users_update_with_http_info variant
+#### Using the update_user_profile_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<UsersUpdate200Response>, Integer, Hash)> users_update_with_http_info(update_user_request)
+> <Array(<UpdateUserProfile200Response>, Integer, Hash)> update_user_profile_with_http_info(update_user_request)
 
 ```ruby
 begin
   # Update user profile
-  data, status_code, headers = api_instance.users_update_with_http_info(update_user_request)
+  data, status_code, headers = api_instance.update_user_profile_with_http_info(update_user_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <UsersUpdate200Response>
+  p data # => <UpdateUserProfile200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_update_with_http_info: #{e}"
+  puts "Error when calling UsersApi->update_user_profile_with_http_info: #{e}"
 end
 ```
 
@@ -751,15 +850,15 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **update_user_request** | [**UpdateUserRequest**](UpdateUserRequest.md) | Profile fields to update (firstName, lastName, avatar). |  |
+| **update_user_request** | [**UpdateUserRequest**](UpdateUserRequest.md) |  |  |
 
 ### Return type
 
-[**UsersUpdate200Response**](UsersUpdate200Response.md)
+[**UpdateUserProfile200Response**](UpdateUserProfile200Response.md)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -767,13 +866,13 @@ end
 - **Accept**: application/json
 
 
-## users_verify2fa
+## verify2_fa
 
-> <MessageResponse> users_verify2fa(users_verify2fa_request)
+> <MessageResponse> verify2_fa(verify2_fa_request)
 
 Verify and enable 2FA
 
-Verify and enable two-factor authentication for the current user. Accepts JWT Bearer token (BearerToken). API keys are not supported for this endpoint. 
+Verify and enable two-factor authentication for the current user. Accepts JWT Bearer token (OrgBearerAuth or ProjectBearerAuth - both are the same JWT token format). API keys are not supported for this endpoint. 
 
 ### Examples
 
@@ -782,37 +881,40 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::UsersApi.new
-users_verify2fa_request = Mudbase::UsersVerify2faRequest.new({token: '123456'}) # UsersVerify2faRequest | One-time code from the authenticator app.
+verify2_fa_request = Mudbase::Verify2FARequest.new({token: '123456'}) # Verify2FARequest | 
 
 begin
   # Verify and enable 2FA
-  result = api_instance.users_verify2fa(users_verify2fa_request)
+  result = api_instance.verify2_fa(verify2_fa_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_verify2fa: #{e}"
+  puts "Error when calling UsersApi->verify2_fa: #{e}"
 end
 ```
 
-#### Using the users_verify2fa_with_http_info variant
+#### Using the verify2_fa_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> users_verify2fa_with_http_info(users_verify2fa_request)
+> <Array(<MessageResponse>, Integer, Hash)> verify2_fa_with_http_info(verify2_fa_request)
 
 ```ruby
 begin
   # Verify and enable 2FA
-  data, status_code, headers = api_instance.users_verify2fa_with_http_info(users_verify2fa_request)
+  data, status_code, headers = api_instance.verify2_fa_with_http_info(verify2_fa_request)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_verify2fa_with_http_info: #{e}"
+  puts "Error when calling UsersApi->verify2_fa_with_http_info: #{e}"
 end
 ```
 
@@ -820,7 +922,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **users_verify2fa_request** | [**UsersVerify2faRequest**](UsersVerify2faRequest.md) | One-time code from the authenticator app. |  |
+| **verify2_fa_request** | [**Verify2FARequest**](Verify2FARequest.md) |  |  |
 
 ### Return type
 
@@ -828,7 +930,7 @@ end
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -836,13 +938,13 @@ end
 - **Accept**: application/json
 
 
-## users_verify_email
+## verify_email
 
-> <MessageResponse> users_verify_email(auth_verify_email_request)
+> <MessageResponse> verify_email(verify_email_auth_request)
 
-Verify email address (with optional project context)
+Verify email address (organization and project)
 
-Verifies the user's email using the token from the link sent at signup. Supports general and project-scoped signups; the token comes from the verification link (e.g. `verify-email?token=...` or `verify-email?token=...&project=...`). 
+Verifies the user's email using the token from the link sent at signup. Works for both organization (platform) and project-based signups; the token is from the verification link (e.g. verify-email?token=... for org, or verify-email?token=...&project=... for project). 
 
 ### Examples
 
@@ -851,32 +953,32 @@ require 'time'
 require 'mudbase'
 
 api_instance = Mudbase::UsersApi.new
-auth_verify_email_request = Mudbase::AuthVerifyEmailRequest.new({token: 'token_example'}) # AuthVerifyEmailRequest | Verification token from the email link; optional projectId for project context.
+verify_email_auth_request = Mudbase::VerifyEmailAuthRequest.new({token: 'token_example'}) # VerifyEmailAuthRequest | 
 
 begin
-  # Verify email address (with optional project context)
-  result = api_instance.users_verify_email(auth_verify_email_request)
+  # Verify email address (organization and project)
+  result = api_instance.verify_email(verify_email_auth_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_verify_email: #{e}"
+  puts "Error when calling UsersApi->verify_email: #{e}"
 end
 ```
 
-#### Using the users_verify_email_with_http_info variant
+#### Using the verify_email_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> users_verify_email_with_http_info(auth_verify_email_request)
+> <Array(<MessageResponse>, Integer, Hash)> verify_email_with_http_info(verify_email_auth_request)
 
 ```ruby
 begin
-  # Verify email address (with optional project context)
-  data, status_code, headers = api_instance.users_verify_email_with_http_info(auth_verify_email_request)
+  # Verify email address (organization and project)
+  data, status_code, headers = api_instance.verify_email_with_http_info(verify_email_auth_request)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling UsersApi->users_verify_email_with_http_info: #{e}"
+  puts "Error when calling UsersApi->verify_email_with_http_info: #{e}"
 end
 ```
 
@@ -884,7 +986,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **auth_verify_email_request** | [**AuthVerifyEmailRequest**](AuthVerifyEmailRequest.md) | Verification token from the email link; optional projectId for project context. |  |
+| **verify_email_auth_request** | [**VerifyEmailAuthRequest**](VerifyEmailAuthRequest.md) |  |  |
 
 ### Return type