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