# Get user's pinned posts

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.

Endpoint: GET /api/v1/posts/pins
Version: 1.0
Security: header

## Query parameters:

  - `ownerId` (string,null)
    Scope owner to resolve the post context
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

  - `postOnly` (boolean,null)
    Returns top posts only or posts + replies

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 404 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation