Edit a user account already defined in the API user's subscription. This API does not support session based authentication.
Using this API you can edit and clear parameters. Learn more
Permissions - Click here for user related permissions
Here's some guidelines on editing users when using the Edit User API.
Edit Parameters - An existing user may be edited using user.php to update the user name and general information. Additional parameters can be edited using the Qualys user interface. When editing parameters using user.php, existing parameter values are replaced with newly specified ones. For example, if you edit an existing Scanner with the assigned asset group “New York” and you wish to add the asset group “Hong Kong”, then the edit request must include asset_groups=New+York,Hong+Kong
Clear Parameters - An edit user request can be used to clear (reset) parameters by assigning the empty string ““.
| Parameter | Required/Optional | Data Type | Description |
|---|---|---|---|
| action=edit | Required | String | Specify action to edit user. |
| login={login} | Required | String | The Qualys user login of the user account you wish to edit. |
| {parameters} | Some parameters are required | String | Click here for listing of user parameters |
API Request
https://<qualys_base_url>/msp/user.php?action=edit&login=quays_ch&title=CIO
XML Output
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE USER_OUTPUT SYSTEM "https://<qualys_base_url>/user_output.dtd">
<USER_OUTPUT>
<API name="user.php" username="user@123" at="2018-07-20T23:06:35Z" />
<RETURN status="SUCCESS">
<MESSAGE>
quays_ch user has been successfully updated.
</MESSAGE>
</RETURN>
</USER_OUTPUT>
<platform API server>/user_output.dtd