@blezgo/api-sdk 0.1.2 → 0.1.4

package/dist/user/generated.d.ts

@@ -17,8 +17,8 @@ export interface paths {
          *     **For**: Admin users managing organization users
          *     **Purpose**: Lists all users in the organization with filtering options
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.view.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         get: operations["listUsers"];
         put?: never;
@@ -29,8 +29,8 @@ export interface paths {
          *     **For**: Admin users adding new users to the organization
          *     **Purpose**: Creates a new user with specified role and permissions
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.create.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["createUser"];
         delete?: never;
@@ -39,6 +39,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/users/admin/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Stats
+         * @description Get user statistics for the organization.
+         *
+         *     **For**: Admin users viewing dashboard metrics
+         *     **Purpose**: Provides overview statistics of users in the organization
+         *
+         *     **Authentication**: Required (JWT token with user.view.all permission)
+         *     **Headers**: Authorization (admin JWT)
+         */
+        get: operations["getUserStats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/users/admin/{user_id}": {
         parameters: {
             query?: never;
@@ -53,8 +79,8 @@ export interface paths {
          *     **For**: Admin users viewing detailed user information
          *     **Purpose**: Retrieves complete user profile and settings
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.view.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         get: operations["getUser"];
         put?: never;
@@ -66,8 +92,8 @@ export interface paths {
          *     **For**: Admin users removing users from the organization
          *     **Purpose**: Soft deletes (default) or permanently removes a user
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.delete.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         delete: operations["deleteUser"];
         options?: never;
@@ -79,8 +105,8 @@ export interface paths {
          *     **For**: Admin users updating user profiles
          *     **Purpose**: Updates user profile information (not including password or role)
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.edit.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         patch: operations["updateUser"];
         trace?: never;
@@ -101,8 +127,8 @@ export interface paths {
          *     **For**: Admin users blocking problematic users
          *     **Purpose**: Disables user access and optionally notifies them
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["blockUser"];
         /**
@@ -112,8 +138,8 @@ export interface paths {
          *     **For**: Admin users restoring blocked user access
          *     **Purpose**: Re-enables user access and resets login attempts
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         delete: operations["unblockUser"];
         options?: never;
@@ -137,8 +163,8 @@ export interface paths {
          *     **For**: Admin users manually verifying user emails
          *     **Purpose**: Marks user email as verified without requiring verification link
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["verifyUserEmail"];
         delete?: never;
@@ -163,8 +189,8 @@ export interface paths {
          *     **For**: Admin users manually verifying user mobile numbers
          *     **Purpose**: Marks user mobile as verified without requiring OTP
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["verifyUserMobile"];
         delete?: never;
@@ -193,8 +219,8 @@ export interface paths {
          *     **For**: Admin users managing user roles and permissions
          *     **Purpose**: Updates user role and associated permissions in org_users_tbl, roles_tbl, access_layer_tbl, and user_access_layer_tbl
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.manage.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         patch: operations["updateUserRole"];
         trace?: never;
@@ -216,7 +242,8 @@ export interface paths {
          *     **Purpose**: Administratively sets a new password for a user
          *
          *     **Authentication**: Required (JWT token with user.manage.all permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Headers**: Authorization (admin JWT)
+         *     **Permissions**: user.manage.all
          */
         post: operations["resetUserPassword"];
         delete?: never;
@@ -272,7 +299,7 @@ export interface paths {
          *     - Support: Help user understand their access level
          *
          *     **Authentication**: Required (JWT token with user_permission.view.all permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Headers**: Authorization (admin JWT)
          *     **Permissions**: user_permission.view.all
          */
         get: operations["listUserPermissions"];
@@ -309,7 +336,7 @@ export interface paths {
          *     4. Deny
          *
          *     **Authentication**: Required (JWT token with user_permission.grant.all permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Headers**: Authorization (admin JWT)
          *     **Permissions**: user_permission.grant.all
          */
         post: operations["createUserPermission"];
@@ -337,7 +364,7 @@ export interface paths {
          *     **Purpose**: Remove user-specific permission override, user reverts to role permissions
          *
          *     **Path Parameters**:
-         *     - user_id: Target user's internal ID
+         *     - user_id: Target user's external ID (usr_xxx)
          *     - override_id: Override external ID (uacl_xxx)
          *
          *     **Query Parameters**:
@@ -351,7 +378,7 @@ export interface paths {
          *     **Note**: Soft delete for recoverability, audit log entry created
          *
          *     **Authentication**: Required (JWT token with user_permission.revoke.all permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Headers**: Authorization (admin JWT)
          *     **Permissions**: user_permission.revoke.all
          */
         delete: operations["deleteUserPermission"];
@@ -360,32 +387,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/users/admin/bulk-registrations": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Bulk Register Users
-         * @description Register multiple users at once.
-         *
-         *     **For**: Admin users creating multiple user accounts in bulk
-         *     **Purpose**: Creates multiple user accounts with passwords
-         *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
-         */
-        post: operations["bulkRegisterUsers"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/v1/users/admin/bulk-updates": {
         parameters: {
             query?: never;
@@ -402,8 +403,8 @@ export interface paths {
          *     **For**: Admin users updating multiple users with same data
          *     **Purpose**: Applies same updates to multiple users
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.edit.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["bulkUpdateUsers"];
         delete?: never;
@@ -428,8 +429,8 @@ export interface paths {
          *     **For**: Admin users removing multiple users
          *     **Purpose**: Deletes multiple users (soft or hard delete)
          *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
+         *     **Authentication**: Required (JWT token with user.delete.all permission)
+         *     **Headers**: Authorization (admin JWT)
          */
         post: operations["bulkDeleteUsers"];
         delete?: never;
@@ -438,95 +439,10 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/users/admin/stats": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get User Stats
-         * @description Get user statistics for the organization.
-         *
-         *     **For**: Admin users viewing dashboard metrics
-         *     **Purpose**: Provides overview statistics of users in the organization
-         *
-         *     **Authentication**: Required (JWT token with api_access permission)
-         *     **Headers**: X-Api-Key (org_id), Authorization (admin user)
-         */
-        get: operations["getUserStats"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
-        /** BlockUserRequest */
-        BlockUserRequest: {
-            /** Reason */
-            reason?: string | null;
-            /**
-             * Notify User
-             * @default false
-             */
-            notify_user: boolean | null;
-        };
-        /** BulkRegisterUser */
-        BulkRegisterUser: {
-            /**
-             * Email
-             * Format: email
-             */
-            email: string;
-            /** Password */
-            password: string;
-            /** First Name */
-            first_name: string;
-            /** Last Name */
-            last_name?: string | null;
-            /**
-             * Role Id
-             * @description Role ID for the user
-             */
-            role_id: number;
-            /** Mobile Isd Code */
-            mobile_isd_code?: string | null;
-            /** Mobile No */
-            mobile_no?: string | null;
-        };
-        /** BulkUpdateRequest */
-        BulkUpdateRequest: {
-            /** User Ids */
-            user_ids: number[];
-            updates: components["schemas"]["UpdateUserRequest"];
-        };
-        /** BulkDeleteRequest */
-        BulkDeleteRequest: {
-            /** User Ids */
-            user_ids: number[];
-            /**
-             * Soft Delete
-             * @default true
-             */
-            soft_delete: boolean | null;
-        };
-        /** BulkRegisterRequest */
-        BulkRegisterRequest: {
-            /** Users */
-            users: components["schemas"]["BulkRegisterUser"][];
-            /**
-             * Send Welcome Email
-             * @default true
-             */
-            send_welcome_email: boolean | null;
-        };
         /** AddUserRequest */
         AddUserRequest: {
             /**
@@ -569,14 +485,19 @@ export interface components {
              */
             send_welcome_email: boolean | null;
         };
-        Extensions: {
-            /** @example GENERIC_ERROR */
-            message_code?: string;
-            /** @example [] */
-            invalid_params?: components["schemas"]["InvalidParam"][];
-            extra_data?: Record<string, never> | null;
-            /** @example Detailed debug information */
-            debug?: string | null;
+        InvalidParam: {
+            /** @example items[0].quantity */
+            field?: string;
+            /** @example Input should be greater than or equal to 1 */
+            error?: string;
+        };
+        /** ChangeUserRoleRequest */
+        ChangeUserRoleRequest: {
+            /**
+             * Role Id
+             * @description New role ID for the user
+             */
+            role_id: number;
         };
         /**
          * @example {
@@ -605,315 +526,139 @@ export interface components {
             metadata?: Record<string, never> | null;
             error?: components["schemas"]["ErrorResponse"];
         };
-        /** UpdateUserRequest */
-        UpdateUserRequest: {
-            /** First Name */
-            first_name?: string | null;
-            /** Last Name */
-            last_name?: string | null;
-            /** Username */
-            username?: string | null;
-            /** Mobile Isd Code */
-            mobile_isd_code?: string | null;
-            /** Mobile No */
-            mobile_no?: string | null;
-            /** Timezone */
-            timezone?: string | null;
-            /** Preferred Language */
-            preferred_language?: string | null;
-            /** Address1 */
-            address1?: string | null;
-            /** Address2 */
-            address2?: string | null;
-            /** City */
-            city?: string | null;
-            /** State */
-            state?: string | null;
-            /** Country */
-            country?: string | null;
-            /** Zip */
-            zip?: string | null;
-        };
-        /** ChangeUserRoleRequest */
-        ChangeUserRoleRequest: {
+        /** BulkDeleteRequest */
+        BulkDeleteRequest: {
             /**
-             * Role Id
-             * @description New role ID for the user
+             * User Ids
+             * @description List of user external IDs (usr_xxx)
              */
-            role_id: number;
-        };
-        ErrorResponse: {
-            /** @example about:blank */
-            type?: string;
-            /** @example GENERIC_ERROR */
-            code?: string;
-            /** @example Client Error */
-            title?: string;
-            /** @example 400 */
-            status?: number;
-            /** @example An error occurred */
-            detail?: string;
-            /** @example /v1/cart/items */
-            instance?: string;
-            extensions?: components["schemas"]["Extensions"];
-        };
-        /** ResetPasswordRequest */
-        ResetPasswordRequest: {
-            /** New Password */
-            new_password: string;
+            user_ids: string[];
             /**
-             * Send Email
+             * Soft Delete
              * @default true
              */
-            send_email: boolean | null;
-        };
-        InvalidParam: {
-            /** @example items[0].quantity */
-            field?: string;
-            /** @example Input should be greater than or equal to 1 */
-            error?: string;
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export interface operations {
-    listUsers: {
-        parameters: {
-            query?: {
-                /** @description Search by name, email, username */
-                query?: string | null;
-                /** @description Filter by role ID */
-                role_id?: number | null;
-                /** @description Filter by status: active, blocked, inactive */
-                status?: string | null;
-                /** @description Filter by email verification status */
-                email_verified?: boolean | null;
-                /** @description Filter by mobile verification status */
-                mobile_verified?: boolean | null;
-                /** @description Sort field: created, name, email */
-                sort_by?: string | null;
-                /** @description Sort order: asc, desc */
-                order?: string | null;
-                /** @description Page number (1-based) */
-                page?: number;
-                /** @description Items per page (1–100, default 20) */
-                limit?: number;
-            };
-            header?: {
-                authorization?: string | null;
-            };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": unknown;
-                };
-            };
-            /** @description Bad Request */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "status": "error",
-                     *       "message": "An error occurred",
-                     *       "message_code": "GENERIC_ERROR",
-                     *       "metadata": {
-                     *         "timestamp": "2025-08-05T18:38:57Z",
-                     *         "requestId": "uuid",
-                     *         "traceId": "uuid",
-                     *         "version": "v1",
-                     *         "executionTime": 0,
-                     *         "language": "en-US",
-                     *         "links": [
-                     *           {
-                     *             "rel": "self",
-                     *             "href": "/v1/cart/items",
-                     *             "method": "POST"
-                     *           }
-                     *         ]
-                     *       },
-                     *       "error": {
-                     *         "type": "https://{your-domain}/errors/client-error",
-                     *         "code": "GENERIC_ERROR",
-                     *         "title": "Client Error",
-                     *         "status": 400,
-                     *         "detail": "An error occurred",
-                     *         "instance": "/v1/cart/items",
-                     *         "extensions": {
-                     *           "message_code": "GENERIC_ERROR",
-                     *           "invalid_params": []
-                     *         }
-                     *       }
-                     *     }
-                     */
-                    "application/json": components["schemas"]["StandardResponse"];
-                };
-            };
-            /** @description Unprocessable Entity */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "status": "error",
-                     *       "message": "One or more input fields are invalid",
-                     *       "message_code": "INVALID_INPUT",
-                     *       "metadata": {
-                     *         "timestamp": "2025-08-05T18:38:57Z",
-                     *         "requestId": "uuid",
-                     *         "traceId": "uuid",
-                     *         "version": "v1",
-                     *         "executionTime": 0,
-                     *         "language": "en-US",
-                     *         "links": [
-                     *           {
-                     *             "rel": "self",
-                     *             "href": "/v1/cart/items",
-                     *             "method": "POST"
-                     *           }
-                     *         ]
-                     *       },
-                     *       "error": {
-                     *         "type": "https://{your-domain}/errors/invalid-input",
-                     *         "code": "INVALID_INPUT",
-                     *         "title": "Invalid Input",
-                     *         "status": 422,
-                     *         "detail": "One or more input fields are invalid",
-                     *         "instance": "/v1/cart/items",
-                     *         "extensions": {
-                     *           "message_code": "INVALID_INPUT",
-                     *           "invalid_params": [
-                     *             {
-                     *               "field": "items[0].quantity",
-                     *               "error": "Input should be greater than or equal to 1"
-                     *             }
-                     *           ]
-                     *         }
-                     *       }
-                     *     }
-                     */
-                    "application/json": components["schemas"]["StandardResponse"];
-                };
-            };
-            /** @description Too Many Requests */
-            429: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "status": "error",
-                     *       "message": "Too many requests",
-                     *       "message_code": "RATE_LIMIT_EXCEEDED",
-                     *       "metadata": {
-                     *         "timestamp": "2025-08-05T18:38:57Z",
-                     *         "requestId": "uuid",
-                     *         "traceId": "uuid",
-                     *         "version": "v1",
-                     *         "executionTime": 0,
-                     *         "language": "en-US",
-                     *         "links": [
-                     *           {
-                     *             "rel": "self",
-                     *             "href": "/v1/cart/items",
-                     *             "method": "POST"
-                     *           }
-                     *         ]
-                     *       },
-                     *       "error": {
-                     *         "type": "https://{your-domain}/errors/rate-limit-exceeded",
-                     *         "code": "RATE_LIMIT_EXCEEDED",
-                     *         "title": "Rate Limit Exceeded",
-                     *         "status": 429,
-                     *         "detail": "Too many requests",
-                     *         "instance": "/v1/cart/items",
-                     *         "extensions": {
-                     *           "message_code": "RATE_LIMIT_EXCEEDED",
-                     *           "invalid_params": []
-                     *         }
-                     *       }
-                     *     }
-                     */
-                    "application/json": components["schemas"]["StandardResponse"];
-                };
-            };
-            /** @description Internal Server Error */
-            500: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "status": "error",
-                     *       "message": "An unexpected error occurred",
-                     *       "message_code": "SERVER_ERROR",
-                     *       "metadata": {
-                     *         "timestamp": "2025-08-05T18:38:57Z",
-                     *         "requestId": "uuid",
-                     *         "traceId": "uuid",
-                     *         "version": "v1",
-                     *         "executionTime": 0,
-                     *         "language": "en-US",
-                     *         "links": [
-                     *           {
-                     *             "rel": "self",
-                     *             "href": "/v1/cart/items",
-                     *             "method": "POST"
-                     *           }
-                     *         ]
-                     *       },
-                     *       "error": {
-                     *         "type": "https://{your-domain}/errors/server-error",
-                     *         "code": "SERVER_ERROR",
-                     *         "title": "Server Error",
-                     *         "status": 500,
-                     *         "detail": "An unexpected error occurred",
-                     *         "instance": "/v1/cart/items",
-                     *         "extensions": {
-                     *           "message_code": "SERVER_ERROR",
-                     *           "invalid_params": []
-                     *         }
-                     *       }
-                     *     }
-                     */
-                    "application/json": components["schemas"]["StandardResponse"];
-                };
-            };
+            soft_delete: boolean | null;
+        };
+        /** ResetPasswordRequest */
+        ResetPasswordRequest: {
+            /** New Password */
+            new_password: string;
+            /**
+             * Send Email
+             * @default true
+             */
+            send_email: boolean | null;
+        };
+        /** BulkUpdateRequest */
+        BulkUpdateRequest: {
+            /**
+             * User Ids
+             * @description List of user external IDs (usr_xxx)
+             */
+            user_ids: string[];
+            updates: components["schemas"]["UpdateUserRequest"];
+        };
+        /** BlockUserRequest */
+        BlockUserRequest: {
+            /** Reason */
+            reason?: string | null;
+            /**
+             * Notify User
+             * @default false
+             */
+            notify_user: boolean | null;
+        };
+        ErrorResponse: {
+            /** @example about:blank */
+            type?: string;
+            /** @example GENERIC_ERROR */
+            code?: string;
+            /** @example Client Error */
+            title?: string;
+            /** @example 400 */
+            status?: number;
+            /** @example An error occurred */
+            detail?: string;
+            /** @example /v1/cart/items */
+            instance?: string;
+            extensions?: components["schemas"]["Extensions"];
+        };
+        Extensions: {
+            /** @example GENERIC_ERROR */
+            message_code?: string;
+            /** @example [] */
+            invalid_params?: components["schemas"]["InvalidParam"][];
+            extra_data?: Record<string, never> | null;
+            /** @example Detailed debug information */
+            debug?: string | null;
+        };
+        /** UpdateUserRequest */
+        UpdateUserRequest: {
+            /** First Name */
+            first_name?: string | null;
+            /** Last Name */
+            last_name?: string | null;
+            /** Username */
+            username?: string | null;
+            /** Mobile Isd Code */
+            mobile_isd_code?: string | null;
+            /** Mobile No */
+            mobile_no?: string | null;
+            /** Timezone */
+            timezone?: string | null;
+            /** Preferred Language */
+            preferred_language?: string | null;
+            /** Address1 */
+            address1?: string | null;
+            /** Address2 */
+            address2?: string | null;
+            /** City */
+            city?: string | null;
+            /** State */
+            state?: string | null;
+            /** Country */
+            country?: string | null;
+            /** Zip */
+            zip?: string | null;
         };
     };
-    createUser: {
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listUsers: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Search by email, username, or name */
+                query?: string | null;
+                /** @description Filter by role external ID (e.g. role_xxx) */
+                role_id?: string | null;
+                /** @description Filter by status: active, blocked, inactive */
+                status?: string | null;
+                /** @description Filter by email verification status */
+                email_verified?: boolean | null;
+                /** @description Filter by mobile verification status */
+                mobile_verified?: boolean | null;
+                /** @description Sort field: created, name, email */
+                sort_by?: string | null;
+                /** @description Sort order: asc, desc */
+                order?: string | null;
+                /** @description Page number (1-based) */
+                page?: number;
+                /** @description Items per page (1–100, default 20) */
+                limit?: number;
+            };
             header?: {
                 authorization?: string | null;
             };
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["AddUserRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -1103,18 +848,20 @@ export interface operations {
             };
         };
     };
-    getUser: {
+    createUser: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
-            path: {
-                user_id: number;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddUserRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -1304,18 +1051,13 @@ export interface operations {
             };
         };
     };
-    deleteUser: {
+    getUserStats: {
         parameters: {
-            query?: {
-                /** @description Soft delete (default) or hard delete */
-                soft_delete?: boolean;
-            };
+            query?: never;
             header?: {
                 authorization?: string | null;
             };
-            path: {
-                user_id: number;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -1508,22 +1250,18 @@ export interface operations {
             };
         };
     };
-    updateUser: {
+    getUser: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["UpdateUserRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -1713,22 +1451,21 @@ export interface operations {
             };
         };
     };
-    blockUser: {
+    deleteUser: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Soft delete (default) or hard delete */
+                soft_delete?: boolean;
+            };
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["BlockUserRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -1918,18 +1655,22 @@ export interface operations {
             };
         };
     };
-    unblockUser: {
+    updateUser: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateUserRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -2119,18 +1860,22 @@ export interface operations {
             };
         };
     };
-    verifyUserEmail: {
+    blockUser: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BlockUserRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -2320,14 +2065,14 @@ export interface operations {
             };
         };
     };
-    verifyUserMobile: {
+    unblockUser: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
@@ -2521,22 +2266,18 @@ export interface operations {
             };
         };
     };
-    updateUserRole: {
+    verifyUserEmail: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ChangeUserRoleRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -2726,22 +2467,18 @@ export interface operations {
             };
         };
     };
-    resetUserPassword: {
+    verifyUserMobile: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["ResetPasswordRequest"];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -2931,18 +2668,22 @@ export interface operations {
             };
         };
     };
-    listUserPermissions: {
+    updateUserRole: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ChangeUserRoleRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -3132,21 +2873,25 @@ export interface operations {
             };
         };
     };
-    createUserPermission: {
+    resetUserPassword: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
+                user_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ResetPasswordRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -3333,18 +3078,14 @@ export interface operations {
             };
         };
     };
-    deleteUserPermission: {
+    listUserPermissions: {
         parameters: {
-            query?: {
-                /** @description Reason for revocation */
-                reason?: string | null;
-            };
+            query?: never;
             header?: {
                 authorization?: string | null;
             };
             path: {
-                user_id: number;
-                override_id: string;
+                user_id: string;
             };
             cookie?: never;
         };
@@ -3538,23 +3279,21 @@ export interface operations {
             };
         };
     };
-    bulkRegisterUsers: {
+    createUserPermission: {
         parameters: {
             query?: never;
             header?: {
                 authorization?: string | null;
             };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["BulkRegisterRequest"];
+            path: {
+                user_id: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -3741,20 +3480,22 @@ export interface operations {
             };
         };
     };
-    bulkUpdateUsers: {
+    deleteUserPermission: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Reason for revocation */
+                reason?: string | null;
+            };
             header?: {
                 authorization?: string | null;
             };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["BulkUpdateRequest"];
+            path: {
+                user_id: string;
+                override_id: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -3944,7 +3685,7 @@ export interface operations {
             };
         };
     };
-    bulkDeleteUsers: {
+    bulkUpdateUsers: {
         parameters: {
             query?: never;
             header?: {
@@ -3955,7 +3696,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["BulkDeleteRequest"];
+                "application/json": components["schemas"]["BulkUpdateRequest"];
             };
         };
         responses: {
@@ -4147,7 +3888,7 @@ export interface operations {
             };
         };
     };
-    getUserStats: {
+    bulkDeleteUsers: {
         parameters: {
             query?: never;
             header?: {
@@ -4156,7 +3897,11 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BulkDeleteRequest"];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {