Skip to navigation

Remove admins from child organizations

Removes each submitted admin from each submitted child organization of the authenticated organization, in one call. Each pair gets the same result as Remove in the app: the admin loses their group and entity roles and leaves the child organization. A member who is not an admin of the child organization is reported as NOT_AN_ADMIN and nothing changes for them. Their Deel login and their other organizations are untouched. Deel never removes the last admin of a child organization: when a request would remove every admin of one, the last of them in the request is kept and reported as LAST_ADMIN, and nothing changes for that pair. The whole request is rejected, and nothing is written, when any id is not a direct child organization of the caller.

Token scopes: organizations:write

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

curl -X GET 'https://api.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

The people to remove and the child organizations to remove them from.
dataobjectRequired
The request payload.

Response

The outcome for every admin and child organization pair.
dataobject
The outcome of the request.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error