Delete user

delete

https://cloud.tenable.com/users/{user_id}

Deletes a user.

Requires the Administrator [64] user role or the PS.ACCT_MGMT.AM_ACCESS_CONTROL.DELETE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

user_id

uuid

required

Specifies the UUID (uuid) or unique ID (id) of the user to delete.

Query Params

successor_user_uuid

uuid

Specifies the unique identifier (UUID) of the user to assign the deleted user's objects to. The successor user must have permission to own the deleted user's objects; otherwise, the request returns a 409 response and the user is not deleted. If the value does not match an existing user, the request returns a 404 response, and specifying the user being deleted returns a 400 response.

Note: Web App Scanning scans created by the deleted user are not automatically reassigned. Reassign WAS scans manually before deleting the user.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Returned if your request specified invalid parameters or if your request was improperly formatted.

403

Returned if you do not have permission to delete the specified user.

404

Returned if Tenable Vulnerability Management cannot find the specified user or successor user.

409

Returned if you attempt to delete your own account, or if the successor user does not have permission to own the deleted user's objects.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the user was deleted successfully.

401Returned if the API keys specified in your request are invalid.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if an internal error occurred.