Qualys Enterprise TruRisk™ Platform 3.25.1 API Notification

Anushka Damle

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

Share your Comments

Comments

Your email address will not be published. Required fields are marked *