@omnibase/core-js 0.8.0 → 0.9.1

package/docs/TenantsApi.md

@@ -0,0 +1,1243 @@
+# TenantsApi
+
+All URIs are relative to *http://https://api.omnibase.tech/api/v1*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**acceptInvite**](TenantsApi.md#acceptinvite) | **PUT** /tenants/invites/accept | Accept tenant invite |
+| [**assignRole**](TenantsApi.md#assignrole) | **POST** /tenants/roles/assign/{user_id} | Assign role to user |
+| [**createInvite**](TenantsApi.md#createinvite) | **POST** /tenants/invites | Create tenant invite |
+| [**createRole**](TenantsApi.md#createrole) | **POST** /tenants/roles | Create role |
+| [**createTenant**](TenantsApi.md#createtenant) | **POST** /tenants | Create tenant |
+| [**deleteRole**](TenantsApi.md#deleterole) | **DELETE** /tenants/roles/{role_id} | Delete role |
+| [**deleteTenant**](TenantsApi.md#deletetenant) | **DELETE** /tenants | Delete tenant |
+| [**getRoleDefinitions**](TenantsApi.md#getroledefinitions) | **GET** /tenants/roles/definitions | Get namespace definitions |
+| [**getTenantBillingStatus**](TenantsApi.md#gettenantbillingstatus) | **GET** /tenants/billing-status | Get billing status |
+| [**getTenantJWT**](TenantsApi.md#gettenantjwt) | **GET** /tenants/jwt | Get PostgREST JWT token |
+| [**listRoles**](TenantsApi.md#listroles) | **GET** /tenants/roles | List roles |
+| [**listTenantSubscriptions**](TenantsApi.md#listtenantsubscriptions) | **GET** /tenants/subscriptions | Get tenant subscriptions |
+| [**listTenantUsers**](TenantsApi.md#listtenantusers) | **GET** /tenants/users | Get tenant users |
+| [**removeTenantUser**](TenantsApi.md#removetenantuser) | **DELETE** /tenants/users | Remove tenant user |
+| [**switchActiveTenant**](TenantsApi.md#switchactivetenant) | **PUT** /tenants/switch-active | Switch active tenant |
+| [**updateRole**](TenantsApi.md#updaterole) | **PUT** /tenants/roles/{role_id} | Update role |
+| [**updateTenantUserRole**](TenantsApi.md#updatetenantuserrole) | **PUT** /tenants/users/role | Update user role |
+
+
+
+## acceptInvite
+
+> AcceptInvite200Response acceptInvite(request)
+
+Accept tenant invite
+
+Accepts a tenant invitation using the token from the invite email and adds the user to the organization.  ## Authentication Requires JWT token. User\'s email must match the invite email.  ## Process 1. Validates invite token and expiry 2. Verifies user\'s email matches invite email 3. Marks invite as used 4. Adds user to tenant 5. Assigns role with permissions 6. Sets as active tenant and returns JWT token
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { AcceptInviteRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsAcceptInviteRequest | Invite acceptance parameters
+    request: ...,
+  } satisfies AcceptInviteRequest;
+
+  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 |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsAcceptInviteRequest](TenantsAcceptInviteRequest.md) | Invite acceptance parameters | |
+
+### Return type
+
+[**AcceptInvite200Response**](AcceptInvite200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successfully joined organization |  -  |
+| **400** | Invalid or expired invite token |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Email mismatch - invite sent to different address |  -  |
+| **500** | Failed to accept invite |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## assignRole
+
+> AssignRole200Response assignRole(userId, request)
+
+Assign role to user
+
+Assigns a role to a user and creates all associated Keto relationships for the role\'s permissions.  ## Authentication Requires JWT token with tenant context and appropriate permissions.  ## Request Format Provide either `role_id` or `role_name` (not both).  ## Use Cases - Grant role to user - Assign permissions via role - User onboarding
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { AssignRoleRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // string | User ID
+    userId: userId_example,
+    // TenantsAssignRoleRequest | Role assignment parameters
+    request: ...,
+  } satisfies AssignRoleRequest;
+
+  try {
+    const data = await api.assignRole(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **userId** | `string` | User ID | [Defaults to `undefined`] |
+| **request** | [TenantsAssignRoleRequest](TenantsAssignRoleRequest.md) | Role assignment parameters | |
+
+### Return type
+
+[**AssignRole200Response**](AssignRole200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Role assigned successfully |  -  |
+| **400** | Invalid request or missing tenant ID |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **404** | Role not found |  -  |
+| **500** | Failed to assign role |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createInvite
+
+> CreateInvite200Response createInvite(request)
+
+Create tenant invite
+
+Creates a tenant invitation with a 7-day expiry token and sends an email to the invited user.  ## Authentication Requires JWT token with `invite_user` permission.  ## Process 1. Verifies user has invite permission 2. Creates invite with unique token (7-day expiry) 3. Sends invitation email asynchronously  ## Use Cases - Add team members to organization - Invite collaborators with specific roles
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { CreateInviteRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsCreateTenantUserInviteRequest | Invite creation parameters
+    request: ...,
+  } satisfies CreateInviteRequest;
+
+  try {
+    const data = await api.createInvite(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsCreateTenantUserInviteRequest](TenantsCreateTenantUserInviteRequest.md) | Invite creation parameters | |
+
+### Return type
+
+[**CreateInvite200Response**](CreateInvite200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Invite sent successfully |  -  |
+| **400** | Invalid request format |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Insufficient permissions to invite users |  -  |
+| **404** | Tenant not found |  -  |
+| **500** | Failed to create invite |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createRole
+
+> CreateRole200Response createRole(request)
+
+Create role
+
+Creates a new custom role for the tenant with specified permissions.  ## Authentication Requires JWT token with tenant context and appropriate permissions.  ## Permission Format Permissions should be in the format: `namespace:resource#relation` - Tenant-wide: `tenant#relation` - Resource-specific: `project:uuid#relation`  ## Use Cases - Create custom roles for specific workflows - Define project-specific permissions - Build granular access control
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { CreateRoleRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsCreateRoleRequest | Role creation parameters
+    request: ...,
+  } satisfies CreateRoleRequest;
+
+  try {
+    const data = await api.createRole(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsCreateRoleRequest](TenantsCreateRoleRequest.md) | Role creation parameters | |
+
+### Return type
+
+[**CreateRole200Response**](CreateRole200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Role created successfully |  -  |
+| **400** | Invalid request or missing tenant ID |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **500** | Failed to create role |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## createTenant
+
+> CreateTenant200Response createTenant(request)
+
+Create tenant
+
+Creates a new tenant organization with Stripe customer, sets up owner role, and makes it the active tenant for the creator.  ## Authentication Requires JWT token.  ## Process 1. Creates Stripe customer (if billing_email provided) 2. Creates tenant in database 3. Sets up default tenant settings 4. Adds creator as owner 5. Assigns owner role with all permissions 6. Sets as active tenant and returns JWT token
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { CreateTenantRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsCreateTenantRequest | Tenant creation parameters
+    request: ...,
+  } satisfies CreateTenantRequest;
+
+  try {
+    const data = await api.createTenant(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsCreateTenantRequest](TenantsCreateTenantRequest.md) | Tenant creation parameters | |
+
+### Return type
+
+[**CreateTenant200Response**](CreateTenant200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Tenant created successfully |  -  |
+| **400** | Invalid request format |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **500** | Failed to create tenant |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## deleteRole
+
+> DeleteRole200Response deleteRole(roleId)
+
+Delete role
+
+Deletes a role and removes all associated Keto relationships for users who had this role assigned.  ## Authentication Requires JWT token with tenant context and appropriate permissions.  ## Use Cases - Remove obsolete roles - Clean up role definitions - Revoke all permissions from role users
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { DeleteRoleRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // string | Role ID
+    roleId: roleId_example,
+  } satisfies DeleteRoleRequest;
+
+  try {
+    const data = await api.deleteRole(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **roleId** | `string` | Role ID | [Defaults to `undefined`] |
+
+### Return type
+
+[**DeleteRole200Response**](DeleteRole200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Role deleted successfully |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **404** | Role not found |  -  |
+| **500** | Failed to delete role |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## deleteTenant
+
+> DeleteTenant200Response deleteTenant()
+
+Delete tenant
+
+Deletes a tenant organization and performs cleanup of Stripe customer, Keto permissions, and user associations.  ## Authentication Requires JWT token with `delete_tenant` permission.  ## Process 1. Verifies user has delete permission 2. Archives Stripe customer 3. Deletes tenant (cascades to users, settings, invites) 4. Cleans up all affected users\' tenant state
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { DeleteTenantRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.deleteTenant();
+    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
+
+[**DeleteTenant200Response**](DeleteTenant200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Tenant deleted successfully |  -  |
+| **400** | Missing tenant ID |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Insufficient permissions to delete tenant |  -  |
+| **404** | Tenant not found |  -  |
+| **500** | Failed to delete tenant |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getRoleDefinitions
+
+> GetRoleDefinitions200Response getRoleDefinitions()
+
+Get namespace definitions
+
+Returns all available permission namespaces and their relations from the database.  ## Authentication Requires JWT token with appropriate permissions.  ## Use Cases - Discover available permission namespaces - List relations for each namespace - Build dynamic permission UIs
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { GetRoleDefinitionsRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.getRoleDefinitions();
+    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
+
+[**GetRoleDefinitions200Response**](GetRoleDefinitions200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Namespace definitions retrieved successfully |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **500** | Failed to fetch definitions |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getTenantBillingStatus
+
+> GetTenantBillingStatus200Response getTenantBillingStatus()
+
+Get billing status
+
+Checks whether the tenant has billing information configured in Stripe and if it\'s active.  ## Authentication Requires JWT token with tenant context.  ## Use Cases - Check if billing setup is required - Conditional feature access - Payment method verification
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { GetTenantBillingStatusRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.getTenantBillingStatus();
+    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
+
+[**GetTenantBillingStatus200Response**](GetTenantBillingStatus200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Billing status retrieved successfully |  -  |
+| **401** | User not authenticated |  -  |
+| **404** | Tenant not found |  -  |
+| **500** | Failed to check billing status |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getTenantJWT
+
+> GetTenantJWT200Response getTenantJWT()
+
+Get PostgREST JWT token
+
+Generates a JWT token for direct PostgREST database access with the user\'s active tenant context.  ## Authentication Requires JWT token and active tenant.  ## Use Cases - Client-side database queries - Real-time subscriptions - Direct PostgREST API access
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { GetTenantJWTRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.getTenantJWT();
+    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
+
+[**GetTenantJWT200Response**](GetTenantJWT200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | JWT token generated successfully |  -  |
+| **400** | No active tenant found |  -  |
+| **401** | User not authenticated |  -  |
+| **500** | Failed to create JWT token |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listRoles
+
+> ListRoles200Response listRoles()
+
+List roles
+
+Returns all roles for the authenticated tenant, including both system roles and custom tenant-specific roles.  ## Authentication Requires JWT token with tenant context.  ## Use Cases - Display available roles to assign - Role management UI - Permission auditing
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { ListRolesRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.listRoles();
+    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
+
+[**ListRoles200Response**](ListRoles200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Roles retrieved successfully |  -  |
+| **400** | Missing tenant ID |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **500** | Failed to list roles |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listTenantSubscriptions
+
+> ListTenantSubscriptions200Response listTenantSubscriptions()
+
+Get tenant subscriptions
+
+Returns all active Stripe subscriptions associated with the tenant\'s Stripe customer.  ## Authentication Requires JWT token with tenant context.  ## Use Cases - Display current subscriptions - Billing overview - Subscription management UI
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { ListTenantSubscriptionsRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.listTenantSubscriptions();
+    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
+
+[**ListTenantSubscriptions200Response**](ListTenantSubscriptions200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Tenant subscriptions retrieved successfully |  -  |
+| **401** | User not authenticated |  -  |
+| **404** | Tenant not found |  -  |
+| **500** | Failed to fetch subscriptions |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## listTenantUsers
+
+> ListTenantUsers200Response listTenantUsers()
+
+Get tenant users
+
+Returns all users who are members of the tenant with their profile information and roles.  ## Authentication Requires JWT token with `view_users` permission.  ## Use Cases - Display team members list - User management UI - Member directory
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { ListTenantUsersRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  try {
+    const data = await api.listTenantUsers();
+    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
+
+[**ListTenantUsers200Response**](ListTenantUsers200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Tenant users retrieved successfully |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Insufficient permissions - must have view_users permission |  -  |
+| **500** | Failed to fetch tenant users |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## removeTenantUser
+
+> HandlersSuccessResponse removeTenantUser(request)
+
+Remove tenant user
+
+Removes a user from the tenant and cleans up all associated permissions and Keto relationships.  ## Authentication Requires JWT token with `remove_user` permission.  ## Restrictions - Cannot remove the last owner (must have at least one owner) - Removing an owner requires `remove_owner_role` permission  ## Process 1. Verifies permissions 2. Removes from role\'s user list 3. Deletes all Keto relationships 4. Removes from database 5. Cleans up user\'s tenant state
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { RemoveTenantUserRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsDeleteTenantUserRequest | User removal parameters
+    request: ...,
+  } satisfies RemoveTenantUserRequest;
+
+  try {
+    const data = await api.removeTenantUser(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsDeleteTenantUserRequest](TenantsDeleteTenantUserRequest.md) | User removal parameters | |
+
+### Return type
+
+[**HandlersSuccessResponse**](HandlersSuccessResponse.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | User removed successfully |  -  |
+| **400** | Invalid request or cannot remove last owner |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Insufficient permissions |  -  |
+| **404** | User not found in tenant |  -  |
+| **500** | Failed to remove user |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## switchActiveTenant
+
+> SwitchActiveTenant200Response switchActiveTenant(request)
+
+Switch active tenant
+
+Updates the user\'s active tenant in Kratos identity and returns a new JWT token with updated tenant context.  ## Authentication Requires JWT token.  ## Use Cases - Switch between organizations - Change context for multi-tenant users
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { SwitchActiveTenantRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsSwitchTenantRequest | Tenant switch parameters
+    request: ...,
+  } satisfies SwitchActiveTenantRequest;
+
+  try {
+    const data = await api.switchActiveTenant(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsSwitchTenantRequest](TenantsSwitchTenantRequest.md) | Tenant switch parameters | |
+
+### Return type
+
+[**SwitchActiveTenant200Response**](SwitchActiveTenant200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successfully switched tenants |  -  |
+| **400** | Invalid request format |  -  |
+| **401** | User not authenticated |  -  |
+| **500** | Failed to switch tenant |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updateRole
+
+> CreateRole200Response updateRole(roleId, request)
+
+Update role
+
+Updates the permissions for an existing role. This will update Keto relationships for all users assigned to this role.  ## Authentication Requires JWT token with tenant context and appropriate permissions.  ## Permission Format Permissions should be in the format: `namespace:resource#relation`  ## Use Cases - Modify role permissions - Grant or revoke access - Update role capabilities
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { UpdateRoleRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // string | Role ID
+    roleId: roleId_example,
+    // TenantsUpdateRoleRequest | Role update parameters
+    request: ...,
+  } satisfies UpdateRoleRequest;
+
+  try {
+    const data = await api.updateRole(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **roleId** | `string` | Role ID | [Defaults to `undefined`] |
+| **request** | [TenantsUpdateRoleRequest](TenantsUpdateRoleRequest.md) | Role update parameters | |
+
+### Return type
+
+[**CreateRole200Response**](CreateRole200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Role updated successfully |  -  |
+| **400** | Invalid request |  -  |
+| **401** | Invalid or missing JWT token |  -  |
+| **404** | Role not found |  -  |
+| **500** | Failed to update role |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updateTenantUserRole
+
+> UpdateTenantUserRole200Response updateTenantUserRole(request)
+
+Update user role
+
+Updates a user\'s role in the tenant and updates all associated Keto permissions.  ## Authentication Requires JWT token with `update_user_role` permission.  ## Restrictions - Promoting to owner requires `update_user_role_to_owner` permission - Demoting from owner requires `remove_owner_role` permission - Cannot demote the last owner (must have at least one owner)  ## Process 1. Verifies permissions 2. Removes old role permissions 3. Updates database 4. Assigns new role permissions
+
+### Example
+
+```ts
+import {
+  Configuration,
+  TenantsApi,
+} from '@omnibase/core-js';
+import type { UpdateTenantUserRoleRequest } from '@omnibase/core-js';
+
+async function example() {
+  console.log("🚀 Testing @omnibase/core-js SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: BearerAuth
+    apiKey: "YOUR API KEY",
+  });
+  const api = new TenantsApi(config);
+
+  const body = {
+    // TenantsUpdateTenantUserRoleRequest | Role update parameters
+    request: ...,
+  } satisfies UpdateTenantUserRoleRequest;
+
+  try {
+    const data = await api.updateTenantUserRole(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **request** | [TenantsUpdateTenantUserRoleRequest](TenantsUpdateTenantUserRoleRequest.md) | Role update parameters | |
+
+### Return type
+
+[**UpdateTenantUserRole200Response**](UpdateTenantUserRole200Response.md)
+
+### Authorization
+
+[BearerAuth](../README.md#BearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | User role updated successfully |  -  |
+| **400** | Invalid request or cannot demote last owner |  -  |
+| **401** | User not authenticated |  -  |
+| **403** | Insufficient permissions |  -  |
+| **404** | User not found in tenant |  -  |
+| **500** | Failed to update role |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+