Delete User
Use this API to delete a user.
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 - Delete UserSample - Delete User
API request
curl --location --request DELETE '<qualys_base_url>/adminui/user-management/v1/user' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT_Token>' \
--data '{
"deleteUsers": "<username1>",
"newOwner": "<username2>"
}'
If user ownership needs to be provided, that must be added in the newOwner field. NewOwner can be fetched from the List Nominee Users API. It provides the nominee user based on the 'qwebuserrole' parameter of the user being deleted.
API Response
{
"userId": 957239015,
"username": "<username3>",
"status": "SUCCESS"
}
V2.0
The new version of this API is compliant to RESTful conventions. The legacy V1 endpoint remain the same.
With this API, you can delete a single user by their numeric user ID. You can optionally reassign objects owned by the deleted user to another user using the newOwnerId query parameter, and permanently remove the associated scan and map results by setting deleteResults=true. This resource-oriented endpoint provides the same capability as the existing v1 delete user API.
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 Parameters Input Parameters
| Parameter | Mandatory/ Optional |
Data Type | Description |
|---|---|---|---|
| userId | Mandatory | Integer | Specify the numeric ID of the user to delete |
| newOwnerId | Optional | Integer | Specify the existing user ID to whom the deleted user's configurations must be transferred. |
| deleteResults | Optional | Boolean | Specify the value true or false. This parameter determines if the scan results must be deleted. |
Sample - Delete a User by IDSample - Delete a User by ID
API Request
curl --location --request DELETE '<qualys_base_url>/adminui/user-management/v2/users/{userId}?newOwnerId={newOwnerId}&deleteResults=true' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <JWT_Token>'API Response
{
"userId": 1072480495,
"username": "<username>",
"status": "SUCCESS"
}API Version History
| API Version | API Status | Release Date |
|---|---|---|
| /adminui/user-management/v1/user | To be deprecated | March 2027 |
| /adminui/user-management/v2/users/{userId} | Active | Oct 2026 |