DELETE organization/…/staff/…

Disconnects a staff user account from the organization. The account itself is not removed, but turned into a regular managed account.

Note that this operation may fail if the staff user is still a manager or viewer of any of the organization's groups.

Resource URL

https://www.drillster.com/api/2/organization/{organization_id}/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_id 400 (Bad request) No user ID was supplied
missing_organization_id 400 (Bad request) No organization ID was supplied
caller_not_part_of_organization 400 (Bad request) Caller is not part of an organization
organization_not_found 404 (Not found) Organization not found
not_part_of_organization 400 (Bad request) Caller is not part of an organization
no_access 401 (Unauthorized) No access to organization
not_found 404 (Not found) Staff user not found
cannot_demote_self 403 (Forbidden) Not allowed to disconnect own user from organization
not_staff_user 400 (Bad request) Not a staff user
staff_disconnection_failed 400 (Bad request) Staff user could not be disconnected from the organization; see message for explanation