# Group Pins

API endpoints for managing pinned groups. Users can pin groups they are a member of to keep them easily accessible. Pinned groups support custom ordering via pin numbers and appear first in the user's group list. All endpoints require authentication.

## Get user's pinned groups

 - [GET /api/v1/groups/pinned](https://docs.wellesley.social/openapi/group-pins/paths/~1api~1v1~1groups~1pinned/get.md): Retrieve all groups pinned by the current user, ordered by pin number. Each group includes viewer context: isMember (always true), pin, and canManage.

## Unpin a group

 - [DELETE /api/v1/groups/{groupId}/pin](https://docs.wellesley.social/openapi/group-pins/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1pin/delete.md): Removes a group from the user's pinned list. The user must be a member of the group. Authentication is required.

## Pin a group

 - [PUT /api/v1/groups/{groupId}/pin](https://docs.wellesley.social/openapi/group-pins/paths/~1api~1v1~1groups~1%7Bgroupid%7D~1pin/put.md): Pins a group to the user's pinned list with an optional order number. The user must be a member of the group. If no pin number is provided, the next available number is assigned automatically. Authentication is required.