# Categories

Endpoints for managing forum-specific categories

## List all categories in a forum

 - [GET /api/v1/groups/{groupId}/categories](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories/get.md): Returns a paginated list of all categories within the specified forum. Categories organize forum discussions into topics.

## Create a new forum category

 - [POST /api/v1/groups/{groupId}/categories](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories/post.md): Creates a new category within a forum. Categories organize forum discussions into topics.

RBAC: requires GroupForum.Manage

## Get forum category by name

 - [GET /api/v1/groups/{groupId}/categories/name/{categoryName}](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories~1name~1%7Bcategoryname%7D/get.md): Retrieves a specific category within a forum by its unique name identifier.

## Check if category name is already in use

 - [GET /api/v1/groups/{groupId}/categories/namecheck/{categoryName}](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories~1namecheck~1%7Bcategoryname%7D/get.md): Validates category name availability within the forum during creation. Returns whether the name is already taken within the group's forum. Requires GroupForum.Manage permission.

RBAC: requires GroupForum.Manage

## Update an existing category

 - [PUT /api/v1/groups/{groupId}/categories/{categoryId}](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories~1%7Bcategoryid%7D/put.md): Updates category properties including name, description, allowed tags, and metadata. Only authenticated users with appropriate permissions can update categories.

RBAC: requires GroupForum.Manage

## Get category details by ID

 - [GET /api/v1/groups/{groupId}/categories/{categoryId}](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories~1%7Bcategoryid%7D/get.md): Retrieves detailed information about a specific category including its name, description, allowed tags, and metadata. Public access allowed.

## Delete a forum category

 - [DELETE /api/v1/groups/{groupId}/categories/{categoryId}](https://docs.wellesley.social/openapi/categories/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1categories~1%7Bcategoryid%7D/delete.md): Permanently deletes a category from a forum. Cannot delete the last category in a forum - at least one category must remain. Requires authentication and appropriate permissions.

RBAC: requires GroupForum.Manage