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