Skip to main content
Permanently delete a group from an organization. This action cannot be undone.
Deleting a group will:
  • Remove all users from the group
  • Delete all policies and permissions associated with the group
  • Remove all relations connected to this group
  • This action is irreversible

​
Path Parameters

​
id
string
required
The unique identifier of the group to delete.

​
Query Parameters

​
org_id
string
required
The organization ID that the group belongs to. Required for authorization.

​
Response

Returns an empty response with HTTP status 200 on successful deletion. 
curl -X DELETE 'https://frontier.example.com/v1beta1/groups/grp_123456789?org_id=org_123' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{}

​
Best Practices

Before deleting a group:
  1. Review dependencies: Check if any resources depend on this group’s permissions
  2. Audit members: Ensure removing group access won’t lock users out of critical resources
  3. Consider disabling first: Use the Disable Group endpoint to temporarily deactivate instead of deleting
  4. Export data: Save group metadata and member lists if needed for records

​
Alternative: Disable Group

If you want to temporarily deactivate a group without permanently deleting it, consider using the Disable Group endpoint instead. This preserves the group data while preventing its use. 
curl -X POST 'https://frontier.example.com/v1beta1/organizations/org_123/groups/grp_123456789/disable' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Build docs developers (and LLMs) love

Get started for freeTalk to us