# Forums

Endpoints for managing discussion forums, including creation, retrieval, and deletion

## Update forum settings

 - [PUT /api/v1/groups/{groupId}/forum](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum/put.md): Updates forum configuration including visibility, policy, and metadata. Requires authentication and appropriate permissions.

RBAC: requires GroupForum.Manage

## Get group's forum

 - [GET /api/v1/groups/{groupId}/forum](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum/get.md): Retrieves detailed information about a specific forum including its visibility settings, policy, and metadata. If the group doesn't have a forum, automatically creates a new forum with default categories. Visible according to Group settings.

## Delete a forum

 - [DELETE /api/v1/groups/{groupId}/forum](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum/delete.md): Permanently deletes a forum and all its associated data. This action is irreversible. Requires authentication and owner permissions.

RBAC: requires GroupForum.Manage

## Permanently delete a forum

 - [DELETE /api/v1/groups/{groupId}/forum/hard](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum~1hard/delete.md): Permanently deletes a forum and all its associated categories. Requires authentication and forum management permissions. Administrative operation.

RBAC: requires GroupData.Manage

## Get forum statistics

 - [GET /api/v1/groups/{groupId}/forum/stats](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum~1stats/get.md): Returns statistics for the forum including number of categories and tags

## List all forum tags

 - [GET /api/v1/groups/{groupId}/forum/tags](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum~1tags/get.md): Returns a paginated list of all tags used within the specified forum, sorted by usage frequency.

## Search forum tags for autocompletion

 - [GET /api/v1/groups/{groupId}/forum/tags/search](https://docs.wellesley.social/openapi/forums/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1forum~1tags~1search/get.md): Searches for tags within a forum by prefix, primarily used for tag autocompletion in user interfaces. Returns matching tags sorted by usage frequency.