Delete a group

curl --request DELETE \
  --url https://services.pref.rio/heimdall-admin/api/v1/groups/{group_name} \
  --header 'Authorization: Bearer <token>'

{
  "error": "Invalid authentication credentials",
  "status_code": 401
}

groups

Delete a group

Delete a group from the system with cascading cleanup.

Authorization: Users can delete groups they have permission to manage. Permissions are checked via Cerbos policies.

Cascade Effects:

Use Cases:

Safety: Group deletion is irreversible. Ensure the group is no longer needed before deletion.

DELETE

api

groups

{group_name}

Delete a group

curl --request DELETE \
  --url https://services.pref.rio/heimdall-admin/api/v1/groups/{group_name} \
  --header 'Authorization: Bearer <token>'

{
  "error": "Invalid authentication credentials",
  "status_code": 401
}

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

group_name

string

required

Group deleted successfully