DELETE user/…
Deletes a user account.
The conditions for calling this endpoint are:
- Deleting your own account is not supported;
- The caller must have the
MANAGE_USERS
permission; - The account to be deleted must be managed by an organization;
- The caller must be an administrator of this organization.
Please note It is not guaranteed that all accounts historically set up by an organization are also currently registered as being managed by that organization. The endpoint will not work for these accounts.
Both end user accounts as well as administrator accounts may be deleted using this endpoint.
Various related data is also deleted, including (but not limited to):
- Group memberships
- Practice results
⚠️ Caution The caller has to make sure that an account is safe to delete. The endpoint will not fail if the account is still linked to e.g. groups; it will simply remove those connections.
Resource URL
https://www.drillster.com/api/2.1/user/{user_id}
Error responses
The following error situations are possible:
ID | Response code | Description |
---|---|---|
missing_user_id |
400 (Bad request) | No user ID was specified |
not_found |
404 (Not found) | Account not found |
access_denied |
401 (Unauthorized) | No access to given account |
cannot_delete_self |
400 (Bad request) | Deleting own account is not permitted |
account_not_managed_by_caller |
401 (Unauthorized) | The account is not (yet) managed by the organization of the caller |