Qualys Enterprise TruRisk™ Platform 3.25.1 API Notification
Table of Contents
A new release of Qualys Enterprise TruRisk™ Platform 3.25.1, which was released in October 2026, introduces new v2 APIs. This API notification highlights recently released changes, enabling you to identify use cases that can benefit from the new APIs.
Note: The new APIs in this release are available only in the enhanced Administration application (RBAC 2.0). You can continue using the current Administration APIs, but migrating to RBAC 2.0 gives you access to the latest Administration API capabilities and future enhancements.
User Management v2 APIs
We have introduced a set of V2 User Management APIs that follow RESTful conventions. You can now update, delete, tag, export, and activate or deactivate users through resource-oriented endpoints, including deleting multiple users in a single request. The existing V1 endpoints remain unchanged.
New API: Update User by ID
PUT /adminui/user-management/v2/users/{userId}
DTD or XSD changes: Not Applicable We have introduced this API to fully update a user by their user ID. The API replaces all editable fields of the user with the values in the request body and resets any optional field you omit to its default or null value. This API provides the same capability as the existing V1 Update User API.
New API: Delete User by ID
DELETE /adminui/user-management/v2/users/{userId}
DTD or XSD changes: Not Applicable We have introduced this API to delete a user by their user ID. You can use the optional newOwnerId query parameter to reassign the objects owned by the deleted user to another user, and set the deleteResults parameter to true to permanently remove the scan and map results associated with the user.
New API: Add or Remove Tags for a User
PUT /adminui/user-management/v2/users/{userId}/tags
DTD or XSD changes: Not Applicable We have introduced this API to add or remove tags for a user in bulk. Use the operationType parameter to add tags to or remove tags from the user’s tag list (BULK_ADD_TAGS and BULK_REMOVE_TAGS) or the user’s scoped tags (BULK_ADD_TAGS_TO_SCOPE and BULK_REMOVE_TAGS_FROM_SCOPE).
New API: Update Scoped Tags by User ID
PUT /adminui/user-management/v2/users/{userId}/scoped-tags
DTD or XSD changes: Not Applicable
We have introduced this API to replace, add to, or remove from the scoped tags of a user. The API request must include exactly one of the following parameters: updateTagsInScope, addTagsToScope, or removeTagsFromScope.
New API: Export Users as CSV
POST /adminui/user-management/v2/users/export
DTD or XSD changes: Not Applicable
We have introduced this API to export the user list as a CSV file. The format and timezone query parameters are mandatory. You can optionally include a request body to filter the users to export. This API provides the same capability as the existing V1 Download Users CSV API.
New API: Update User Status
PATCH /adminui/user-management/v2/users/{userId}/status
DTD or XSD changes: Not Applicable We have introduced this API to activate or deactivate a user. The API request includes the action parameter, which you set to ACTIVATE or DEACTIVATE.
New API: Bulk Delete Users
DELETE /adminui/user-management/v2/users
DTD or XSD changes: Not Applicable We have introduced this API to delete multiple users in a single request. Specify the users in the userIds parameter, and set the deleteResults parameter to true to also permanently remove the scan and map results owned by the deleted users.
Password Management APIs
We have introduced new APIs so that you can change your own password, and administrators can trigger a password reset for another user.
New API: Change Password
POST /adminui/user-management/v1/user/password/change
DTD or XSD changes: Not Applicable We have introduced this self-service API so that users can change their own password. The API request includes the oldPassword and newPassword parameters.
New API: Reset Password for Other User
POST /adminui/user-management/v1/user/password/reset
DTD or XSD changes: Not Applicable
We have introduced this API so that administrators can reset the password of another user. The API sends a change-password email to the user specified in the targetUsername parameter. To use this API, you must have the Reset Password for other users permission. Password reset is not supported for SAML-authenticated users, users with the Contact role, or accounts with NCSM (Network-Centric Security Model) enabled.
Please refer to the detailed release notes here:https://docs.qualys.com/en/portal-cloud-platform-rn/cloud_platform/release_3_25_1_api.htm