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. For more information, please refer to the instructions on how to demote a staff user account.
Resource URL
https://www.drillster.com/api/2.1.1/organization/{organization_id}/staff/{user_id}
or
https://www.drillster.com/api/2.1.1/organization/self/staff/{user_id}
Parameters
| Field | Type | Description |
|---|---|---|
organization_idrequired |
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_idrequired |
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 |
Last updated on