DELETE
/users/{username}Delete a user account
Deletes an existing user account identified by its username. Use this operation when you need to remove a user; the username must identify the account to delete.
usernamestringrequired
The username of the user to delete.
200Returns an object containing an `error` description, if any, and a `message`, which can be empty.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
400Returned when the request is invalid.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
401Returned when authentication is missing or invalid.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
403Returned when the authenticated user is not permitted to delete the user.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
404Returned when the specified user cannot be found.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
500Returned when an internal server error occurs.
errorstringoptional
error description if any
messagestringoptional
message, can be empty
defaultUnexpected Error
errorstringoptional
error description if any
messagestringoptional
message, can be empty
Error handling
A 400 is returned for an invalid request. A 401 indicates that authentication is missing or invalid, and a 403 indicates that the authenticated user is not permitted to delete the user. A 404 is returned when the user cannot be found, and a 500 indicates a server error; the username path parameter must identify the user to delete.