# Delete a user

This endpoint deletes a given user.

IMPORTANT NOTE

The deletion of a user is permanent and cannot be undone. The data associated with the user cannot be retrieved.

You cannot delete a user if there is a User Secret associated with that user. You will need to delete the User Secret first by sending a request to the delete_user_secret endpoint.

Method Path Operation*
DELETE /users/{user} delete_user

*

In order for a user to perform the "delete_user" operation, the "delete_user" permission must be included in the list of allowed actions in the statement of the user's role.

# Request

Parameter Type In Description
{user}
required
string path User UUID.

# Response

Attribute Type Description
uuid string User UUID.
name string Name of the user. It must match the regular expression (opens new window) [0-9A-Za-z][0-9A-Za-z_ \-]{0,30}[0-9A-Za-z]. It does not need to be unique in the context of the Account.
account string Account UUID.
role string Role UUID.
description dictionary Attributes of the User in form of key-value pairs:
- key: It must match the regular expression (opens new window) [a-z_][0-9a-z_]{0,63}.
- value: JSON compliant value.
For more details consult the description field section.
created_ts timestamp Time at which the user was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).
updated_ts timestamp Time at which the user was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).

# Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status Codes section.