# Pins

Endpoints for pinning posts to profiles and retrieving pinned posts

## Get user's pinned posts

 - [GET /api/v1/posts/pins](https://docs.wellesley.social/openapi/pins/paths/~1api~1v1~1posts~1pins/get.md): Returns a list of all posts the authenticated user has pinned to their profile. Can optionally filter to show only top-level posts or include replies.

## Unpin a post from profile

 - [DELETE /api/v1/posts/pins/{postId}](https://docs.wellesley.social/openapi/pins/paths/~1api~1v1~1posts~1pins~1%7Bpostid%7D/delete.md): Removes a previously pinned post from the authenticated user's profile.

## Pin a post to profile

 - [POST /api/v1/posts/pins/{postId}](https://docs.wellesley.social/openapi/pins/paths/~1api~1v1~1posts~1pins~1%7Bpostid%7D/post.md): Pins a post to the authenticated user's profile. Only own posts can be pinned, and there is a limit on the number of pinned posts. Direct messages and reposts cannot be pinned.