Delete a group
DELETE/v1/directory/groups/{group_id}
Deletes a group and its role assignments. Its people stay in your organization.
Permission: identity:DeleteGroup. Changes need a sign-in that used a second factor.
Path parameters
| Parameter | Type | Description |
|---|---|---|
group_id |
string | The group's ID. |
Returns
204 No Content, with no body.
Errors
Besides the errors every call can return:
| Status | When |
|---|---|
404 |
No such resource in your organization. |
409 |
It would leave your organization with no administrator. |
Example
curl -X DELETE https://<company>.yotta.bot/v1/directory/groups/3c5e8a90-1d2b-4e6f-8a7c-9b0d1e2f3a4b \
-H "Authorization: Bearer $YOTTABOT_TOKEN"With yottactl
yottactl org groups delete 3c5e8a90-1d2b-4e6f-8a7c-9b0d1e2f3a4b