From 21f5945272179c4081a7ab863c34a495c0c2d28a Mon Sep 17 00:00:00 2001
From: Sergio Matias <sergio.matias@agilewebs.com>
Date: Tue, 2 Sep 2025 08:59:56 -0600
Subject: [PATCH] Fix documentation and add deletes for all collections

---
 .../Controllers/ModuleController.cs           | 36 +++++++++++++--
 .../Controllers/PermissionController.cs       | 36 +++++++++++++--
 .../Controllers/RoleController.cs             | 42 ++++++++++++++---
 .../Controllers/TenantController.cs           | 12 ++---
 .../Controllers/UserController.cs             | 46 +++++++++++++++----
 5 files changed, 140 insertions(+), 32 deletions(-)

diff --git a/Core.Thalos.BFF.Api/Controllers/ModuleController.cs b/Core.Thalos.BFF.Api/Controllers/ModuleController.cs
index eb5c493..e843ffc 100644
--- a/Core.Thalos.BFF.Api/Controllers/ModuleController.cs
+++ b/Core.Thalos.BFF.Api/Controllers/ModuleController.cs
@@ -24,7 +24,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets all modules.
         /// </summary>
         [HttpGet("GetAll")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(IEnumerable<ModuleAdapter>), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -90,7 +90,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Creates a new module.
         /// </summary>
         [HttpPost("Create")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ModuleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -124,7 +124,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the module by identifier.
         /// </summary>
         [HttpPost("GetById")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ModuleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -152,7 +152,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Updates a full module by identifier.
         /// </summary>
         [HttpPut("Update")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ModuleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -187,7 +187,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPatch]
         [Route("ChangeStatus")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(ModuleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -212,6 +212,32 @@ namespace Core.Thalos.BFF.Api.Controllers
             }
         }
 
+        /// <summary>
+        /// Deletes the Module by identifier.
+        /// </summary>
+        [HttpDelete("Delete")]
+        [ProducesResponseType(typeof(ModuleAdapter), StatusCodes.Status200OK)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status422UnprocessableEntity)]
+        [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+        [Permission("ModuleManagement.Write")]
+        public async Task<IActionResult> DeleteModuleByIdService(DeleteModuleRequest request, CancellationToken cancellationToken)
+        {
+            try
+            {
+                logger.LogInformation($"{nameof(DeleteModuleByIdService)} - Request received - Payload: {JsonSerializer.Serialize(request)}");
 
+                if (string.IsNullOrEmpty(request._Id)) return BadRequest("Invalid Module identifier");
+
+                return await Handle(() => thalosServiceClient.DeleteModuleByIdService(request, cancellationToken)).ConfigureAwait(false);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError($"{nameof(DeleteModuleByIdService)} - An Error Occurred- {ex.Message} - {ex.InnerException} - {ex.StackTrace} - with payload {JsonSerializer.Serialize(request)}");
+                throw;
+            }
+        }
     }
 }
diff --git a/Core.Thalos.BFF.Api/Controllers/PermissionController.cs b/Core.Thalos.BFF.Api/Controllers/PermissionController.cs
index ce0e821..0d5b4eb 100644
--- a/Core.Thalos.BFF.Api/Controllers/PermissionController.cs
+++ b/Core.Thalos.BFF.Api/Controllers/PermissionController.cs
@@ -24,7 +24,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets all permissions.
         /// </summary>
         [HttpGet("GetAll")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(IEnumerable<PermissionAdapter>), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -90,7 +90,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Creates a new permission.
         /// </summary>
         [HttpPost("Create")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(PermissionAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -122,7 +122,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the permission by identifier.
         /// </summary>
         [HttpPost("GetById")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(PermissionAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -150,7 +150,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Updates a full permission by identifier.
         /// </summary>
         [HttpPut("Update")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(PermissionAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -183,7 +183,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPatch]
         [Route("ChangeStatus")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(PermissionAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -208,6 +208,32 @@ namespace Core.Thalos.BFF.Api.Controllers
             }
         }
 
+        /// <summary>
+        /// Deletes the Permission by identifier.
+        /// </summary>
+        [HttpDelete("Delete")]
+        [ProducesResponseType(typeof(PermissionAdapter), StatusCodes.Status200OK)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status422UnprocessableEntity)]
+        [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+        [Permission("PermissionManagement.Write")]
+        public async Task<IActionResult> DeletePermissionByIdService(DeletePermissionRequest request, CancellationToken cancellationToken)
+        {
+            try
+            {
+                logger.LogInformation($"{nameof(DeletePermissionByIdService)} - Request received - Payload: {JsonSerializer.Serialize(request)}");
 
+                if (string.IsNullOrEmpty(request._Id)) return BadRequest("Invalid Permission identifier");
+
+                return await Handle(() => thalosServiceClient.DeletePermissionByIdService(request, cancellationToken)).ConfigureAwait(false);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError($"{nameof(DeletePermissionByIdService)} - An Error Occurred- {ex.Message} - {ex.InnerException} - {ex.StackTrace} - with payload {JsonSerializer.Serialize(request)}");
+                throw;
+            }
+        }
     }
 }
diff --git a/Core.Thalos.BFF.Api/Controllers/RoleController.cs b/Core.Thalos.BFF.Api/Controllers/RoleController.cs
index a335bc8..5cacdba 100644
--- a/Core.Thalos.BFF.Api/Controllers/RoleController.cs
+++ b/Core.Thalos.BFF.Api/Controllers/RoleController.cs
@@ -24,7 +24,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets all roles.
         /// </summary>
         [HttpGet("GetAll")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(IEnumerable<RoleAdapter>), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -50,7 +50,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Creates a new role.
         /// </summary>
         [HttpPost("Create")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -88,7 +88,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the role by identifier.
         /// </summary>
         [HttpPost("GetById")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -116,7 +116,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Updates a full role by identifier.
         /// </summary>
         [HttpPut("Update")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -158,7 +158,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPatch]
         [Route("ChangeStatus")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -188,7 +188,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPost]
         [Route("AddApplication")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -218,7 +218,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpDelete]
         [Route("RemoveApplication")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -242,5 +242,33 @@ namespace Core.Thalos.BFF.Api.Controllers
                 throw;
             }
         }
+
+        /// <summary>
+        /// Deletes the Role by identifier.
+        /// </summary>
+        [HttpDelete("Delete")]
+        [ProducesResponseType(typeof(RoleAdapter), StatusCodes.Status200OK)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status422UnprocessableEntity)]
+        [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+        [Permission("RoleManagement.Write")]
+        public async Task<IActionResult> DeleteRoleByIdService(DeleteRoleRequest request, CancellationToken cancellationToken)
+        {
+            try
+            {
+                logger.LogInformation($"{nameof(DeleteRoleByIdService)} - Request received - Payload: {JsonSerializer.Serialize(request)}");
+
+                if (string.IsNullOrEmpty(request._Id)) return BadRequest("Invalid Role identifier");
+
+                return await Handle(() => thalosServiceClient.DeleteRoleByIdService(request, cancellationToken)).ConfigureAwait(false);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError($"{nameof(DeleteRoleByIdService)} - An Error Occurred- {ex.Message} - {ex.InnerException} - {ex.StackTrace} - with payload {JsonSerializer.Serialize(request)}");
+                throw;
+            }
+        }
     }
 }
diff --git a/Core.Thalos.BFF.Api/Controllers/TenantController.cs b/Core.Thalos.BFF.Api/Controllers/TenantController.cs
index 7aada7a..3ca9fe1 100644
--- a/Core.Thalos.BFF.Api/Controllers/TenantController.cs
+++ b/Core.Thalos.BFF.Api/Controllers/TenantController.cs
@@ -24,7 +24,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets all Tenants.
         /// </summary>
         [HttpGet("GetAll")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(IEnumerable<TenantAdapter>), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -50,7 +50,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Creates a new Tenant.
         /// </summary>
         [HttpPost("Create")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(TenantAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -80,7 +80,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the Tenant by identifier.
         /// </summary>
         [HttpPost("GetById")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(TenantAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -108,7 +108,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Updates a full Tenant by identifier.
         /// </summary>
         [HttpPut("Update")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(TenantAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -140,7 +140,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPatch]
         [Route("ChangeStatus")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(TenantAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -169,7 +169,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Deletes the Tenant by identifier.
         /// </summary>
         [HttpDelete("Delete")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(TenantAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
diff --git a/Core.Thalos.BFF.Api/Controllers/UserController.cs b/Core.Thalos.BFF.Api/Controllers/UserController.cs
index 241b8b7..442b0e9 100644
--- a/Core.Thalos.BFF.Api/Controllers/UserController.cs
+++ b/Core.Thalos.BFF.Api/Controllers/UserController.cs
@@ -24,7 +24,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets all users.
         /// </summary>
         [HttpGet("GetAll")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(IEnumerable<UserAdapter>), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -51,7 +51,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Creates a new user.
         /// </summary>
         [HttpPost("Create")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -90,7 +90,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the user by identifier.
         /// </summary>
         [HttpPost("GetById")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -119,7 +119,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the user by email.
         /// </summary>
         [HttpPost("GetByEmail")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -148,7 +148,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Updates a full user by identifier.
         /// </summary>
         [HttpPut("Update")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -185,7 +185,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Logs in the user.
         /// </summary>
         [HttpPatch("LoginUser")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -213,7 +213,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Logs out the user.
         /// </summary>
         [HttpPatch("LogoutUser")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -242,7 +242,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// </summary>
         [HttpPatch]
         [Route("ChangeStatus")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status204NoContent)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
@@ -272,7 +272,7 @@ namespace Core.Thalos.BFF.Api.Controllers
         /// Gets the user by email.
         /// </summary>
         [HttpPost("ValidateExistence")]
-        [ProducesResponseType(StatusCodes.Status200OK)]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
         [ProducesResponseType(StatusCodes.Status400BadRequest)]
         [ProducesResponseType(StatusCodes.Status401Unauthorized)]
         [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
@@ -295,5 +295,33 @@ namespace Core.Thalos.BFF.Api.Controllers
                 throw;
             }
         }
+
+        /// <summary>
+        /// Deletes the User by identifier.
+        /// </summary>
+        [HttpDelete("Delete")]
+        [ProducesResponseType(typeof(UserAdapter), StatusCodes.Status200OK)]
+        [ProducesResponseType(StatusCodes.Status400BadRequest)]
+        [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status412PreconditionFailed)]
+        [ProducesResponseType(typeof(Notification), StatusCodes.Status422UnprocessableEntity)]
+        [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+        [Permission("UserManagement.Write")]
+        public async Task<IActionResult> DeleteUserByIdService(DeleteUserRequest request, CancellationToken cancellationToken)
+        {
+            try
+            {
+                logger.LogInformation($"{nameof(DeleteUserByIdService)} - Request received - Payload: {JsonSerializer.Serialize(request)}");
+
+                if (string.IsNullOrEmpty(request._Id)) return BadRequest("Invalid User identifier");
+
+                return await Handle(() => thalosServiceClient.DeleteUserByIdService(request, cancellationToken)).ConfigureAwait(false);
+            }
+            catch (Exception ex)
+            {
+                logger.LogError($"{nameof(DeleteUserByIdService)} - An Error Occurred- {ex.Message} - {ex.InnerException} - {ex.StackTrace} - with payload {JsonSerializer.Serialize(request)}");
+                throw;
+            }
+        }
     }
 }