Bulk Delete Users

V1.0 | V2.0

V1.0

Use this API to delete multiple users at one time. 

DELETE/adminui/user-management/v1/users/delete

The API request and response are in JSON format. Some characters, such as backslash (\) and double quotes (") in passwords or other fields may appear escaped in raw JSON responses. It is recommended to always parse responses using a standard JSON parser to retrieve the correct values. 

Sample - Bulk Delete UsersSample - Bulk Delete Users

 curl --location --request DELETE '<qualys_base_url>/adminui/user-management/v1/users/delete' \
--header 'X-Requested-With: hfds' \
--header 'Cookie: QualysSession=xxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT token>' \
--data '
{"userIds": [1121646506],"newOwnerId": 1121646504, "deleteResults": false}

{
    "message": "Users successfully deleted"
}

V2.0

The new version of this API is compliant to RESTful conventions. The legacy V1 endpoint remain the same. 
Use this API to delete multiple users in a single request. The userIds array is required and must not be empty; an absent or empty list returns a 400 Bad Request error. Set deleteResults to true to also permanently remove the scan and map results owned by the deleted users. This endpoint provides the same functionality as the existing v1 bulk-delete users API.

DELETE/adminui/user-management/v2/users

The API request and response are in JSON format. Some characters, such as backslash (\) and double quotes (") in passwords or other fields may appear escaped in raw JSON responses. It is recommended to always parse responses using a standard JSON parser to retrieve the correct values. 

Input ParametersInput Parameters

Sample - Bulk Delete UsersSample - Bulk Delete Users

curl --location --request DELETE '<qualys_base_url>/adminui/user-management/v2/users' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT_Token>' \
--data-raw '

{
  "userIds": [
    1072480495,
    1072480496
  ],
  "deleteResults": false
}'

{
  "message": "Users successfully deleted"
}

API Version History