delete_group

Purpose

Deletes a group. Everyone in it loses whatever it granted, all at once, but stays in the team.

Not tier-gated, unlike creating and updating. A creator whose tier lapsed has to be able to take access away. See what the tier gates.

Required ability

group:delete

Input schema

{
  "type": "object",
  "properties": {
    "group_id": {
      "type": "string",
      "description": "UUID of the group to delete. Irreversible."
    }
  },
  "required": ["group_id"]
}

Output shape

{
  "data": {
    "id": "1f68d92a-04c5-4e83-97b1-3d6a05e2f847",
    "deleted": true
  }
}

Emits group.deleted.

Example prompts

"Delete the billing group — the finance role covers it now."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks group:delete.
RESOURCE_NOT_FOUND — no such group in any team the caller belongs to.

sync_group_members — emptying a group leaves it in place for later; deleting removes it entirely.
create_group
update_group
Groups API