# Delete user
This endpoint deletes a given user.
It is not possible to delete a user if there is a User Secret (API key) associated with the given user. In order to delete a user, you will have to delete the User Secret (APi key) of the user first (see delete_user_secret).
IMPORTANT NOTE
The deletion of a user is permanent and cannot be undone. After deleting a user, you will not be able to retrieve data associated with the user.
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). | ||||||||
activity optional ** | dictionary | User Activity Log attribute. It holds the name(s) of the Timeseries table(s) where the User Activity Log is to be stored, and (optionally) the |
Attribute | Type | In | Description |
---|---|---|---|
dimensions | dictionary | body | Key-value pairs: - key: name of the dimension under which the User Activity Log entry is to be stored. - value: Template for the value of the dimension. |
# Status codes
Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.
← Update user Overview →
Was this article helpful?