delete_group
Delete a group. Members stay in the team but lose what it granted.
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.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Fires one event
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it. It reaches beyond Subscriby: a connector, a provider or a member.
Arguments
group_id*stringUUID of the group to delete. Irreversible.
What it returns
{ "data": { "id": "1f68d92a-04c5-4e83-97b1-3d6a05e2f847", "deleted": true }}Emits group.deleted.
How it fails
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks group:delete.
RESOURCE_NOT_FOUNDno such group in any team the caller belongs to.
How is this guide?
Last updated on