Skip to main content
DELETE
Delete a permission group
Deleting a group takes away the access it was giving. Everybody in it loses every grant they held through the group, on all three permission axes, immediately. Grants they hold in their own right are untouched. This cannot be undone — recreating the group means granting it again from nothing.

Response

204, with no body.

Check what you are about to remove

A group’s grants are worth reading before deleting it, because the effect is spread across everybody in it.

Emptying instead of deleting

If the group might be needed again, replacing its membership with an empty list has the same effect on access and keeps the group and its grants intact.

Errors

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Path Parameters

id
string<uuid>
required

The permission group's id.

Response

204

No response body