mudbase-sdk 1.2.9 → 1.3.6

package/docs/AuthenticationApi.md

@@ -0,0 +1,2095 @@
+# AuthenticationApi
+
+All URIs are relative to *https://cloud.mudbase.dev*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**acceptInvite**](AuthenticationApi.md#acceptinviteoperation) | **POST** /api/auth/accept-invite | Accept organization invitation |
+| [**confirmLocalPasswordResetWithOtp**](AuthenticationApi.md#confirmlocalpasswordresetwithotpoperation) | **POST** /api/auth/local/password-reset/confirm | Confirm password reset with OTP (project-based) |
+| [**convertAnonymousAccount**](AuthenticationApi.md#convertanonymousaccountoperation) | **POST** /api/auth/anonymous/convert | Convert anonymous account to full account |
+| [**createAnonymousSession**](AuthenticationApi.md#createanonymoussessionoperation) | **POST** /api/auth/anonymous | Create anonymous session |
+| [**getAvailableOAuthProviders**](AuthenticationApi.md#getavailableoauthproviders) | **GET** /api/auth/oauth/providers/available | Get all available OAuth providers |
+| [**getCurrentSession**](AuthenticationApi.md#getcurrentsession) | **GET** /api/auth/session | Get current session |
+| [**getLocalSession**](AuthenticationApi.md#getlocalsession) | **GET** /api/auth/local/session | Get current session (project-based) |
+| [**getOrgOAuthProviders**](AuthenticationApi.md#getorgoauthproviders) | **GET** /api/auth/oauth-org/providers | Get available OAuth providers for organization-based auth |
+| [**initiateOAuth**](AuthenticationApi.md#initiateoauth) | **GET** /api/auth/oauth/{provider}/{projectId} | Initiate OAuth authentication |
+| [**initiateOrgOAuth**](AuthenticationApi.md#initiateorgoauth) | **GET** /api/auth/oauth-org/{provider} | Initiate OAuth authentication for organization |
+| [**loginLocalUser**](AuthenticationApi.md#loginlocaluseroperation) | **POST** /api/auth/local/login | Login user (project-based) |
+| [**loginUser**](AuthenticationApi.md#loginuser) | **POST** /api/auth/login | Login user |
+| [**logoutLocalUser**](AuthenticationApi.md#logoutlocaluser) | **POST** /api/auth/local/logout | Logout user (project-based) |
+| [**logoutUser**](AuthenticationApi.md#logoutuser) | **POST** /api/auth/logout | Logout user |
+| [**oauthCallback**](AuthenticationApi.md#oauthcallback) | **GET** /api/auth/oauth/callback/{provider} | OAuth callback handler (project-based) |
+| [**orgOAuthCallback**](AuthenticationApi.md#orgoauthcallback) | **GET** /api/auth/oauth-org/callback/{provider} | OAuth callback handler for organization |
+| [**refreshToken**](AuthenticationApi.md#refreshtokenoperation) | **POST** /api/auth/refresh | Refresh access token (org and project) |
+| [**registerLocalUser**](AuthenticationApi.md#registerlocaluseroperation) | **POST** /api/auth/local/register | Register new user (project-based) |
+| [**registerUser**](AuthenticationApi.md#registeruser) | **POST** /api/auth/register | Register new user |
+| [**requestLocalPasswordReset**](AuthenticationApi.md#requestlocalpasswordresetoperation) | **POST** /api/auth/local/password-reset | Request password reset (project-based, OTP) |
+| [**requestPasswordReset**](AuthenticationApi.md#requestpasswordresetoperation) | **POST** /api/auth/password-reset | Request password reset (organization / platform) |
+| [**resendVerificationAuth**](AuthenticationApi.md#resendverificationauthoperation) | **POST** /api/auth/resend-verification | Resend verification email (no auth) |
+| [**resetLocalPassword**](AuthenticationApi.md#resetlocalpasswordoperation) | **POST** /api/auth/local/password-reset/{token} | Reset password with token (project-based, legacy) |
+| [**resetPassword**](AuthenticationApi.md#resetpasswordoperation) | **POST** /api/auth/password-reset/{token} | Reset password with token (organization / platform) |
+| [**sendMagicLink**](AuthenticationApi.md#sendmagiclink) | **POST** /api/auth/magic-link/send | Send magic link |
+| [**sendOTP**](AuthenticationApi.md#sendotp) | **POST** /api/auth/otp/send | Send OTP code |
+| [**validatePasswordResetToken**](AuthenticationApi.md#validatepasswordresettokenoperation) | **POST** /api/auth/password-reset/validate | Validate password reset token |
+| [**verifyEmailAuth**](AuthenticationApi.md#verifyemailauthoperation) | **POST** /api/auth/verify-email | Verify email address (no auth) |
+| [**verifyMagicLink**](AuthenticationApi.md#verifymagiclinkoperation) | **POST** /api/auth/magic-link/verify | Verify magic link |
+| [**verifyOTP**](AuthenticationApi.md#verifyotp) | **POST** /api/auth/otp/verify | Verify OTP code |
+
+
+
+## acceptInvite
+
+> AcceptInvite201Response acceptInvite(acceptInviteRequest)
+
+Accept organization invitation
+
+Accept an organization invitation using the token from the invite email link (e.g. `/invite/{token}?orgId=...`). Creates a new user with the invited email and adds them to the organization with the invited role. Returns a JWT and user so the client can log the user in immediately. No authentication required. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { AcceptInviteOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // AcceptInviteRequest
+    acceptInviteRequest: {"token":"a1b2c3d4e5f6...","password":"SecurePass123!","firstName":"Jane","lastName":"Doe"},
+  } satisfies AcceptInviteOperationRequest;
+
+  try {
+    const data = await api.acceptInvite(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **acceptInviteRequest** | [AcceptInviteRequest](AcceptInviteRequest.md) |  | |
+
+### Return type
+
+[**AcceptInvite201Response**](AcceptInvite201Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Invitation accepted; user created and added to organization |  -  |
+| **400** | Invalid or expired token, or user already exists with this email |  -  |
+| **404** | Organization not found |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## confirmLocalPasswordResetWithOtp
+
+> MessageResponse confirmLocalPasswordResetWithOtp(confirmLocalPasswordResetWithOtpRequest)
+
+Confirm password reset with OTP (project-based)
+
+Set new password using the OTP sent to the user\'s email. Call after POST /api/auth/local/password-reset with projectId. Rate limited (OTP limit). If the user\'s email was not yet verified, it is marked as verified upon successful reset. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ConfirmLocalPasswordResetWithOtpOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // ConfirmLocalPasswordResetWithOtpRequest
+    confirmLocalPasswordResetWithOtpRequest: {"email":"user@example.com","projectId":"685ad30be129932fbb7a1047","otp":"123456","newPassword":"NewSecurePass123!"},
+  } satisfies ConfirmLocalPasswordResetWithOtpOperationRequest;
+
+  try {
+    const data = await api.confirmLocalPasswordResetWithOtp(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **confirmLocalPasswordResetWithOtpRequest** | [ConfirmLocalPasswordResetWithOtpRequest](ConfirmLocalPasswordResetWithOtpRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Password reset successful |  -  |
+| **400** | Invalid or expired OTP, or validation error |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Too many attempts (rate limit) |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## convertAnonymousAccount
+
+> ConvertAnonymousAccount200Response convertAnonymousAccount(convertAnonymousAccountRequest)
+
+Convert anonymous account to full account
+
+Convert an anonymous user session to a full authenticated account. Preserves user data. 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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ConvertAnonymousAccountOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new AuthenticationApi(config);
+
+  const body = {
+    // ConvertAnonymousAccountRequest
+    convertAnonymousAccountRequest: {"email":"user@example.com","password":"SecurePassword123!","firstName":"John","lastName":"Doe"},
+  } satisfies ConvertAnonymousAccountOperationRequest;
+
+  try {
+    const data = await api.convertAnonymousAccount(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **convertAnonymousAccountRequest** | [ConvertAnonymousAccountRequest](ConvertAnonymousAccountRequest.md) |  | |
+
+### Return type
+
+[**ConvertAnonymousAccount200Response**](ConvertAnonymousAccount200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Account converted successfully |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createAnonymousSession
+
+> CreateAnonymousSession200Response createAnonymousSession(createAnonymousSessionRequest)
+
+Create anonymous session
+
+Create an anonymous user session for guest access. Users can later convert to full accounts.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { CreateAnonymousSessionOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // CreateAnonymousSessionRequest (optional)
+    createAnonymousSessionRequest: {"projectId":"685ad30be129932fbb7a1047","deviceId":"device-uuid-123"},
+  } satisfies CreateAnonymousSessionOperationRequest;
+
+  try {
+    const data = await api.createAnonymousSession(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createAnonymousSessionRequest** | [CreateAnonymousSessionRequest](CreateAnonymousSessionRequest.md) |  | [Optional] |
+
+### Return type
+
+[**CreateAnonymousSession200Response**](CreateAnonymousSession200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Anonymous session created |  -  |
+| **400** | Bad request |  -  |
+| **403** | Access denied |  -  |
+| **404** | Resource not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getAvailableOAuthProviders
+
+> GetAvailableOAuthProviders200Response getAvailableOAuthProviders()
+
+Get all available OAuth providers
+
+Returns a list of all supported OAuth providers with their configuration details
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { GetAvailableOAuthProvidersRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  try {
+    const data = await api.getAvailableOAuthProviders();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetAvailableOAuthProviders200Response**](GetAvailableOAuthProviders200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | List of available OAuth providers |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getCurrentSession
+
+> SessionResponse getCurrentSession()
+
+Get current session
+
+Get the current authenticated user session information. 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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { GetCurrentSessionRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new AuthenticationApi(config);
+
+  try {
+    const data = await api.getCurrentSession();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**SessionResponse**](SessionResponse.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Current session |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getLocalSession
+
+> GetLocalSession200Response getLocalSession(projectId)
+
+Get current session (project-based)
+
+Get the current authenticated user session (project-based). 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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { GetLocalSessionRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new AuthenticationApi(config);
+
+  const body = {
+    // string (optional)
+    projectId: projectId_example,
+  } satisfies GetLocalSessionRequest;
+
+  try {
+    const data = await api.getLocalSession(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**GetLocalSession200Response**](GetLocalSession200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Current session |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getOrgOAuthProviders
+
+> GetOrgOAuthProviders200Response getOrgOAuthProviders()
+
+Get available OAuth providers for organization-based auth
+
+Returns a list of OAuth providers that are configured and available for organization-based authentication. Providers are configured via environment variables (e.g., GOOGLE_CLIENT_ID, GITHUB_CLIENT_ID). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { GetOrgOAuthProvidersRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  try {
+    const data = await api.getOrgOAuthProviders();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetOrgOAuthProviders200Response**](GetOrgOAuthProviders200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | List of available OAuth providers |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## initiateOAuth
+
+> initiateOAuth(provider, projectId, redirectUrl)
+
+Initiate OAuth authentication
+
+Initiates OAuth authentication flow for a specified provider and project. The OAuth provider must be configured and enabled for the project first. Returns an HTTP 302 redirect to the OAuth provider\'s consent screen. Note: Swagger \"Try it out\" may show \"Failed to fetch\" for this endpoint due to browser CORS restrictions on cross-origin redirects. Use top-level browser navigation or curl to test. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { InitiateOAuthRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // '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'
+    provider: google,
+    // string
+    projectId: 685ad30be129932fbb7a1047,
+    // string | The URL to redirect to after authentication. Must be pre-registered in project settings. (optional)
+    redirectUrl: https://client.app/auth/callback,
+  } satisfies InitiateOAuthRequest;
+
+  try {
+    const data = await api.initiateOAuth(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **provider** | `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` |  | [Defaults to `undefined`] [Enum: 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] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **redirectUrl** | `string` | The URL to redirect to after authentication. Must be pre-registered in project settings. | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **302** | Redirect to OAuth provider\&#39;s consent screen |  * Location - OAuth provider authorization URL <br>  |
+| **400** | OAuth provider not configured, not enabled, or missing required server/provider credentials |  -  |
+| **404** | Project not found |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## initiateOrgOAuth
+
+> initiateOrgOAuth(provider, redirectUrl)
+
+Initiate OAuth authentication for organization
+
+Initiates OAuth authentication flow for organization-level signup/login. The OAuth provider must be configured via environment variables (e.g., GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET). After successful authentication, creates a new organization and user account, or logs in existing user. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { InitiateOrgOAuthRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // 'google' | 'github' | 'facebook' | 'microsoft' | 'discord' | 'linkedin'
+    provider: google,
+    // string | The URL to redirect to after authentication (optional)
+    redirectUrl: https://client.app/auth/callback,
+  } satisfies InitiateOrgOAuthRequest;
+
+  try {
+    const data = await api.initiateOrgOAuth(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **provider** | `google`, `github`, `facebook`, `microsoft`, `discord`, `linkedin` |  | [Defaults to `undefined`] [Enum: google, github, facebook, microsoft, discord, linkedin] |
+| **redirectUrl** | `string` | The URL to redirect to after authentication | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **302** | Redirect to OAuth provider\&#39;s consent screen |  * Location - OAuth provider authorization URL <br>  |
+| **400** | OAuth provider not configured or not supported |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## loginLocalUser
+
+> LoginLocalUser200Response loginLocalUser(loginLocalUserRequest)
+
+Login user (project-based)
+
+When the project has **requireEmailVerification** enabled and the user has not verified their email, returns 403 with code **EMAIL_VERIFICATION_REQUIRED** (user must verify email first, then login again). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { LoginLocalUserOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // LoginLocalUserRequest
+    loginLocalUserRequest: {"email":"sarah.chen@example.com","password":"SecurePass123!","projectId":"685ad30be129932fbb7a1047"},
+  } satisfies LoginLocalUserOperationRequest;
+
+  try {
+    const data = await api.loginLocalUser(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **loginLocalUserRequest** | [LoginLocalUserRequest](LoginLocalUserRequest.md) |  | |
+
+### Return type
+
+[**LoginLocalUser200Response**](LoginLocalUser200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Login successful |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Email verification required (project has requireEmailVerification and user has not verified) |  -  |
+| **429** | Rate limit exceeded |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## loginUser
+
+> AuthResponse loginUser(loginRequest)
+
+Login user
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { LoginUserRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // LoginRequest
+    loginRequest: {"email":"john.doe@mudbase.dev","password":"SecurePass123!"},
+  } satisfies LoginUserRequest;
+
+  try {
+    const data = await api.loginUser(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **loginRequest** | [LoginRequest](LoginRequest.md) |  | |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Login successful |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## logoutLocalUser
+
+> MessageResponse logoutLocalUser()
+
+Logout user (project-based)
+
+Logout the current authenticated user session (project-based). 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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { LogoutLocalUserRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new AuthenticationApi(config);
+
+  try {
+    const data = await api.logoutLocalUser();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Logout successful |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## logoutUser
+
+> MessageResponse logoutUser()
+
+Logout user
+
+Logout the current authenticated user session. 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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { LogoutUserRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new AuthenticationApi(config);
+
+  try {
+    const data = await api.logoutUser();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Logout successful |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## oauthCallback
+
+> oauthCallback(provider)
+
+OAuth callback handler (project-based)
+
+Handles OAuth callback for project-based authentication. This route must be matched before /api/auth/oauth/{provider}/{projectId}. Redirects to frontend with query params token, refreshToken, and expiresIn. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { OauthCallbackRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // string
+    provider: provider_example,
+  } satisfies OauthCallbackRequest;
+
+  try {
+    const data = await api.oauthCallback(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **provider** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **302** | Redirect with token, refreshToken, and expiresIn |  * Location - URL with token, refreshToken, expiresIn query params <br>  |
+| **400** | Bad request |  -  |
+| **429** | Rate limit exceeded |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## orgOAuthCallback
+
+> orgOAuthCallback(provider, code, state)
+
+OAuth callback handler for organization
+
+Handles OAuth callback for organization-based authentication. Creates a new organization and user account if the user doesn\&#39;t exist, or logs in existing user. Redirects to frontend with query params token, refreshToken, and expiresIn. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { OrgOAuthCallbackRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // 'google' | 'github' | 'facebook' | 'microsoft' | 'discord' | 'linkedin'
+    provider: google,
+    // string | Authorization code from OAuth provider (optional)
+    code: code_example,
+    // string | State parameter for CSRF protection (optional)
+    state: state_example,
+  } satisfies OrgOAuthCallbackRequest;
+
+  try {
+    const data = await api.orgOAuthCallback(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **provider** | `google`, `github`, `facebook`, `microsoft`, `discord`, `linkedin` |  | [Defaults to `undefined`] [Enum: google, github, facebook, microsoft, discord, linkedin] |
+| **code** | `string` | Authorization code from OAuth provider | [Optional] [Defaults to `undefined`] |
+| **state** | `string` | State parameter for CSRF protection | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **302** | Redirect with authentication result |  * Location - URL to redirect to with token, refreshToken, and expiresIn query params <br>  |
+| **400** | OAuth authentication failed |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## refreshToken
+
+> RefreshToken200Response refreshToken(refreshTokenRequest)
+
+Refresh access token (org and project)
+
+Exchange a valid refresh token for a new JWT access token and refresh token. Works for both **org-based** (platform/dashboard) and **project-based** auth; the same endpoint is used. The previous refresh token is invalidated (rotation). If the same refresh token is used again, the session is revoked (reuse detection). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { RefreshTokenOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // RefreshTokenRequest
+    refreshTokenRequest: {"refreshToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},
+  } satisfies RefreshTokenOperationRequest;
+
+  try {
+    const data = await api.refreshToken(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **refreshTokenRequest** | [RefreshTokenRequest](RefreshTokenRequest.md) |  | |
+
+### Return type
+
+[**RefreshToken200Response**](RefreshToken200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | New token pair issued |  -  |
+| **400** | Missing refresh token |  -  |
+| **401** | Invalid or expired refresh token (or reuse detected) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## registerLocalUser
+
+> RegisterLocalUser201Response registerLocalUser(registerLocalUserRequest)
+
+Register new user (project-based)
+
+When the project has **requireEmailVerification** enabled (default), the response is 201 with **requireVerification: true** and **no token**; the user must verify their email then sign in via login. When email verification is disabled, a token and refreshToken are returned. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { RegisterLocalUserOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // RegisterLocalUserRequest
+    registerLocalUserRequest: {"email":"sarah.chen@example.com","password":"SecurePass123!","firstName":"Sarah","lastName":"Chen","projectId":"685ad30be129932fbb7a1047"},
+  } satisfies RegisterLocalUserOperationRequest;
+
+  try {
+    const data = await api.registerLocalUser(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **registerLocalUserRequest** | [RegisterLocalUserRequest](RegisterLocalUserRequest.md) |  | |
+
+### Return type
+
+[**RegisterLocalUser201Response**](RegisterLocalUser201Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | When project.requireEmailVerification is on (default): no token returned; use requireVerification and message to prompt email verification, then user signs in via login. When off: token and refreshToken returned.  |  -  |
+| **400** | Bad request |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Rate limit exceeded |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## registerUser
+
+> AuthResponse registerUser(registerRequest)
+
+Register new user
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { RegisterUserRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // RegisterRequest
+    registerRequest: {"email":"john.doe@mudbase.dev","password":"SecurePass123!","firstName":"John","lastName":"Doe","orgName":"Mudbase"},
+  } satisfies RegisterUserRequest;
+
+  try {
+    const data = await api.registerUser(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **registerRequest** | [RegisterRequest](RegisterRequest.md) |  | |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | User registered successfully |  -  |
+| **400** | Bad request |  -  |
+| **409** | Resource conflict |  -  |
+| **429** | Rate limit exceeded |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## requestLocalPasswordReset
+
+> MessageResponse requestLocalPasswordReset(requestLocalPasswordResetRequest)
+
+Request password reset (project-based, OTP)
+
+When projectId is provided, sends a 6-digit OTP to the user\&#39;s email (project-based reset uses OTP, not link). When projectId is omitted, sends a token link (org/platform local account). Rate limited. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { RequestLocalPasswordResetOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // RequestLocalPasswordResetRequest
+    requestLocalPasswordResetRequest: {"email":"user@example.com","projectId":"685ad30be129932fbb7a1047"},
+  } satisfies RequestLocalPasswordResetOperationRequest;
+
+  try {
+    const data = await api.requestLocalPasswordReset(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **requestLocalPasswordResetRequest** | [RequestLocalPasswordResetRequest](RequestLocalPasswordResetRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OTP or reset email sent (generic message to prevent enumeration) |  -  |
+| **400** | Bad request |  -  |
+| **404** | Resource not found |  -  |
+| **429** | Too many requests (rate limit) |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## requestPasswordReset
+
+> MessageResponse requestPasswordReset(requestPasswordResetRequest)
+
+Request password reset (organization / platform)
+
+Sends a password reset link to the user\&#39;s email. Use this for organization (platform) accounts. For project-based accounts use POST /api/auth/local/password-reset with projectId (sends OTP instead). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { RequestPasswordResetOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // RequestPasswordResetRequest
+    requestPasswordResetRequest: {"email":"john.doe@mudbase.dev"},
+  } satisfies RequestPasswordResetOperationRequest;
+
+  try {
+    const data = await api.requestPasswordReset(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **requestPasswordResetRequest** | [RequestPasswordResetRequest](RequestPasswordResetRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Password reset email sent (or generic message to prevent enumeration) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## resendVerificationAuth
+
+> MessageResponse resendVerificationAuth(resendVerificationAuthRequest)
+
+Resend verification email (no auth)
+
+Sends a new verification email to the given email (and optional project). For unauthenticated users who have not verified yet. Rate limited (e.g. 3 per 15 min per IP). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ResendVerificationAuthOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // ResendVerificationAuthRequest
+    resendVerificationAuthRequest: {"email":"user@example.com"},
+  } satisfies ResendVerificationAuthOperationRequest;
+
+  try {
+    const data = await api.resendVerificationAuth(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **resendVerificationAuthRequest** | [ResendVerificationAuthRequest](ResendVerificationAuthRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Verification email sent (or generic message to prevent enumeration) |  -  |
+| **400** | Email required |  -  |
+| **429** | Too many requests (rate limit) |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## resetLocalPassword
+
+> MessageResponse resetLocalPassword(token, resetLocalPasswordRequest)
+
+Reset password with token (project-based, legacy)
+
+Legacy token-based completion. Prefer OTP flow: use POST .../password-reset/confirm with the OTP sent to email for project-based resets. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ResetLocalPasswordOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // string
+    token: token_example,
+    // ResetLocalPasswordRequest
+    resetLocalPasswordRequest: {"password":"NewSecurePass123!","projectId":"685ad30be129932fbb7a1047"},
+  } satisfies ResetLocalPasswordOperationRequest;
+
+  try {
+    const data = await api.resetLocalPassword(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **token** | `string` |  | [Defaults to `undefined`] |
+| **resetLocalPasswordRequest** | [ResetLocalPasswordRequest](ResetLocalPasswordRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Password reset successful |  -  |
+| **400** | Bad request |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## resetPassword
+
+> MessageResponse resetPassword(token, resetPasswordRequest)
+
+Reset password with token (organization / platform)
+
+Set new password using the token from the reset link. Validate the token first with POST /api/auth/password-reset/validate before showing the form. If the user\&#39;s email was not yet verified, it is marked as verified upon successful reset. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ResetPasswordOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // string
+    token: token_example,
+    // ResetPasswordRequest
+    resetPasswordRequest: {"password":"NewSecurePass123!"},
+  } satisfies ResetPasswordOperationRequest;
+
+  try {
+    const data = await api.resetPassword(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **token** | `string` |  | [Defaults to `undefined`] |
+| **resetPasswordRequest** | [ResetPasswordRequest](ResetPasswordRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Password reset successful |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## sendMagicLink
+
+> MessageResponse sendMagicLink(magicLinkRequest)
+
+Send magic link
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { SendMagicLinkRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // MagicLinkRequest
+    magicLinkRequest: {"email":"user@example.com","projectId":"685ad30be129932fbb7a1047","redirectUrl":"https://app.example.com/auth/callback"},
+  } satisfies SendMagicLinkRequest;
+
+  try {
+    const data = await api.sendMagicLink(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **magicLinkRequest** | [MagicLinkRequest](MagicLinkRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Magic link sent |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## sendOTP
+
+> MessageResponse sendOTP(oTPSendRequest)
+
+Send OTP code
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { SendOTPRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // OTPSendRequest
+    oTPSendRequest: {"email":"user@example.com","projectId":"685ad30be129932fbb7a1047","method":"email"},
+  } satisfies SendOTPRequest;
+
+  try {
+    const data = await api.sendOTP(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **oTPSendRequest** | [OTPSendRequest](OTPSendRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OTP sent |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## validatePasswordResetToken
+
+> ValidatePasswordResetToken200Response validatePasswordResetToken(validatePasswordResetTokenRequest)
+
+Validate password reset token
+
+Call before showing the \&quot;set new password\&quot; form. Validates that the token from the reset link is still valid and not expired. Organization (platform) reset only. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { ValidatePasswordResetTokenOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // ValidatePasswordResetTokenRequest
+    validatePasswordResetTokenRequest: {"token":"abc123..."},
+  } satisfies ValidatePasswordResetTokenOperationRequest;
+
+  try {
+    const data = await api.validatePasswordResetToken(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **validatePasswordResetTokenRequest** | [ValidatePasswordResetTokenRequest](ValidatePasswordResetTokenRequest.md) |  | |
+
+### Return type
+
+[**ValidatePasswordResetToken200Response**](ValidatePasswordResetToken200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Token is valid |  -  |
+| **400** | Token invalid or expired |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## verifyEmailAuth
+
+> MessageResponse verifyEmailAuth(verifyEmailAuthRequest)
+
+Verify email address (no auth)
+
+Verifies the user\&#39;s email using the token from the link sent at signup. Use this for both organization and project signups (unauthenticated). Same behavior as POST /api/users/verify-email. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { VerifyEmailAuthOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // VerifyEmailAuthRequest
+    verifyEmailAuthRequest: {"token":"verification-token-from-email-link"},
+  } satisfies VerifyEmailAuthOperationRequest;
+
+  try {
+    const data = await api.verifyEmailAuth(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **verifyEmailAuthRequest** | [VerifyEmailAuthRequest](VerifyEmailAuthRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Email verified |  -  |
+| **400** | Invalid or missing token |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## verifyMagicLink
+
+> AuthResponse verifyMagicLink(verifyMagicLinkRequest)
+
+Verify magic link
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { VerifyMagicLinkOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // VerifyMagicLinkRequest
+    verifyMagicLinkRequest: {"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6InVzZXJAZXhhbXBsZS5jb20iLCJwcm9qZWN0SWQiOiI2ODVhZDMwYmUxMjk5MzJmYmI3YTEwNDciLCJpYXQiOjE3NTA3ODA4OTgsImV4cCI6MTc1MDc4NDQ5OH0.example"},
+  } satisfies VerifyMagicLinkOperationRequest;
+
+  try {
+    const data = await api.verifyMagicLink(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **verifyMagicLinkRequest** | [VerifyMagicLinkRequest](VerifyMagicLinkRequest.md) |  | |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Magic link verified |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## verifyOTP
+
+> AuthResponse verifyOTP(oTPVerifyRequest)
+
+Verify OTP code
+
+### Example
+
+```ts
+import {
+  Configuration,
+  AuthenticationApi,
+} from 'mudbase-sdk';
+import type { VerifyOTPRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new AuthenticationApi();
+
+  const body = {
+    // OTPVerifyRequest
+    oTPVerifyRequest: {"identifier":"user@example.com","otp":"123456","projectId":"685ad30be129932fbb7a1047"},
+  } satisfies VerifyOTPRequest;
+
+  try {
+    const data = await api.verifyOTP(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **oTPVerifyRequest** | [OTPVerifyRequest](OTPVerifyRequest.md) |  | |
+
+### Return type
+
+[**AuthResponse**](AuthResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | OTP verified |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+