DELETE organization/…/staff

DELETE Disconnects a staff user account from the organization. The account itself is not removed, but turned into a basic account. The user loses management access to any of the organization's groups.

Resource URL

https://www.drillster.com/api/2/organization/{organization_id}/staff/{user_id}

or

https://www.drillster.com/api/2/organization/self/staff/{user_id}

Parameters

Field Type Description
organization_id
required
String

The organization ID to retrieve the staff users for. May be replaced with self to refer to the own organization.

Example value: nPjYUn0upc8dIm7yzTIBgQ

user_id
required
String

The user ID of the staff user to remove.

Response

A NoContent (204) response indicating that the account was successfully disconnected from the organization.

Error responses

The following error situations are possible:

ID Response code Description
missing_staff_user_id400 (Bad request)No user ID was supplied
missing_organization_id400 (Bad request)No organization ID was supplied
caller_not_part_of_organization400 (Bad request)Caller is not part of an organization
organization_not_found404 (Not found)Organization not found
not_part_of_organization400 (Bad request)Caller is not part of an organization
no_access401 (Unauthorized)No access to organization
not_found404 (Not found)Staff user not found
cannot_demote_self403 (Forbidden)Not allowed to disconnect own user from organization
not_staff_user400 (Bad request)Not a staff user
staff_disconnection_failed400 (Bad request)Staff user could not be disconnected from the organization; see message for explanation