# Rules

Manage platform rules that govern user conduct and content policies. Retrieving rules is publicly accessible. Creating, updating, deleting, and reordering rules require authentication and the Rules.Manage RBAC permission. All write operations are logged in the audit trail.

## Update existing rule

 - [PUT /api/v1/rules](https://docs.wellesley.social/openapi/rules/paths/~1api~1v1~1rules/put.md): Modifies an existing platform rule with updated text, hint, or ordering. Requires authentication and the Rules.Manage RBAC permission. Returns 404 if the rule does not exist. The update is logged in the audit trail.

RBAC: requires Rules.Manage

## Get all rules

 - [GET /api/v1/rules](https://docs.wellesley.social/openapi/rules/paths/~1api~1v1~1rules/get.md): Retrieves the complete list of platform rules that users must follow. Publicly accessible without authentication. Rules are returned ordered by their display position.

## Create a rule

 - [POST /api/v1/rules](https://docs.wellesley.social/openapi/rules/paths/~1api~1v1~1rules/post.md): Creates a new platform rule with text content, optional hint explanation, and ordering priority. Requires authentication and the Rules.Manage RBAC permission. The creation is logged in the audit trail.

RBAC: requires Rules.Manage

## Reorder rules

 - [POST /api/v1/rules/reorder](https://docs.wellesley.social/openapi/rules/paths/~1api~1v1~1rules~1reorder/post.md): Updates the display ordering of multiple rules at once by providing new ordering values. Requires authentication and the Rules.Manage RBAC permission. Each reorder operation is logged individually in the audit trail. Returns the complete updated list of rules after reordering.

RBAC: requires Rules.Manage

## Delete existing rule

 - [DELETE /api/v1/rules/{id}](https://docs.wellesley.social/openapi/rules/paths/~1api~1v1~1rules~1%7Bid%7D/delete.md): Permanently removes a platform rule by its ID. Requires authentication and the Rules.Manage RBAC permission. The deletion is logged in the audit trail.

RBAC: requires Rules.Manage