DELETE user/…

Deletes a user account.

There are certain restrictions to the removal of user accounts:

  • The account to be deleted must be either your own account (and not managed by an organization),
  • or it must be another account (and managed by an organization);
  • The account to be removed must not be managing any groups. Remove group management access prior to deleting a user.
  • The caller must have the MANAGE_USERS permission;
  • The caller must be an administrator of this organization.

Keep in mind that various related data is removed, too:

  • Group memberships
  • Practice results

Resource URL

https://www.drillster.com/api/2.1.1/user/{user_id}

Parameters

Field Type Description
skipValidation
optional
Boolean If true, skips the validation, and any possible safeguards regarding groups management. To be used carefully.

Error responses

The following error situations are possible:

ID Response code Description
not_found 404 (Not found) Given account was 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 managed by the organization of the caller
account_is_group_manager 400 (Bad request) The account is managing one or more groups

 

Last updated on