Take a role off an account

DELETE/v1/directory/roles/{role_id}/accounts/{account_id}

Takes a role off an account, so it can no longer be assigned there.

Permission: identity:ProvisionRole. Changes need a sign-in that used a second factor.

Path parameters

Parameter Type Description
role_id string The role's ID.
account_id integer The account's ID.

Returns

204 No Content, with no body.

Errors

Besides the errors every call can return:

Status When
400 The role is not on that account.
404 No such resource in your organization.

Example

curl -X DELETE https://<company>.yotta.bot/v1/directory/roles/5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d/accounts/100000000123 \
  -H "Authorization: Bearer $YOTTABOT_TOKEN"

With yottactl

yottactl org roles remove-account 5a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d 100000000123