# Group Rules

API endpoints for managing community rules within groups. Rules define the expected conduct and content policies that members must follow. Each rule consists of text (the rule itself), a hint (explanation or context), and an ordering value for display sequence. Rules are scoped to specific groups and can be managed by users with appropriate permissions.

## Get all rules for a group

 - [GET /api/v1/groups/{groupId}/rules](https://docs.wellesley.social/openapi/group-rules/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1rules/get.md): Retrieves the complete list of rules for a specific group. Rules are returned in order based on their ordering value (lowest first). This endpoint is publicly accessible as group rules should be visible to potential members before joining. Each rule includes its text content, explanatory hint, and display ordering.

## Create a new group rule

 - [POST /api/v1/groups/{groupId}/rules](https://docs.wellesley.social/openapi/group-rules/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1rules/post.md): Creates a new rule for the specified group. Requires GroupSettings.Manage permission. The rule will be assigned a unique ID and added to the group's rule list. Rules are used to establish community guidelines and expected behavior. An audit log entry is created for this action.

RBAC: requires GroupSettings.Manage

## Reorder multiple group rules

 - [POST /api/v1/groups/{groupId}/rules/reorder](https://docs.wellesley.social/openapi/group-rules/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1rules~1reorder/post.md): Batch updates the display ordering of multiple rules within a group. This endpoint allows efficient reordering of rules without individual API calls. Requires GroupSettings.Manage permission. Each reordering operation is tracked in the audit log. Rules not included in the request maintain their current ordering. Returns all group rules with updated ordering values.

RBAC: requires GroupSettings.Manage

## Delete a group rule

 - [DELETE /api/v1/groups/{groupId}/rules/{id}](https://docs.wellesley.social/openapi/group-rules/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1rules~1%7Bid%7D/delete.md): Permanently removes a rule from the group. Requires GroupSettings.Manage permission. This action cannot be undone. The deletion is recorded in the audit log. Returns 404 if the rule doesn't exist or doesn't belong to the specified group.

RBAC: requires GroupSettings.Manage

## Update an existing group rule

 - [PUT /api/v1/groups/{groupId}/rules/{ruleId}](https://docs.wellesley.social/openapi/group-rules/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1rules~1%7Bruleid%7D/put.md): Modifies an existing rule's text, hint, or ordering. Requires GroupSettings.Manage permission. The entire rule content must be provided in the update request. Changes are tracked in the audit log for compliance and moderation purposes. Returns 404 if the rule doesn't exist.

RBAC: requires GroupSettings.Manage