> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postbreeze.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pull fresh comments from each platform

> Pulls new comments from the social platforms into your inbox.

This goes through every active inbox-capable account in the workspace and asks the platform for new comments since the last time you refreshed. New comments get added to the cache, so the next call to `GET /comments` includes them.

The first refresh on a brand-new account pulls the last 7 days of comments. After that, each refresh just picks up where the last one stopped.

If one platform is having a bad day, the refresh keeps going for the rest — you won't lose updates from Instagram because YouTube timed out.

The response tells you how many new comments came in, so you know whether to re-list. Any member of the workspace can trigger a refresh.



## OpenAPI

````yaml /openapi.json post /comments/refresh
openapi: 3.0.0
info:
  title: Postbreeze API
  description: >-
    Public REST API for scheduling and managing social posts. Authenticate every
    request with `Authorization: Bearer pb_live_…`. All endpoints are scoped to
    a single workspace; an API key issued for workspace A cannot access
    workspace B.
  version: 1.0.0
  contact: {}
servers:
  - url: http://localhost:4100/api/v1
security:
  - bearer: []
tags: []
paths:
  /comments/refresh:
    post:
      tags:
        - Comments
      summary: Pull fresh comments from each platform
      description: >-
        Pulls new comments from the social platforms into your inbox.


        This goes through every active inbox-capable account in the workspace
        and asks the platform for new comments since the last time you
        refreshed. New comments get added to the cache, so the next call to `GET
        /comments` includes them.


        The first refresh on a brand-new account pulls the last 7 days of
        comments. After that, each refresh just picks up where the last one
        stopped.


        If one platform is having a bad day, the refresh keeps going for the
        rest — you won't lose updates from Instagram because YouTube timed out.


        The response tells you how many new comments came in, so you know
        whether to re-list. Any member of the workspace can trigger a refresh.
      operationId: CommentsV1Controller_refresh
      parameters: []
      responses:
        '201':
          description: Refresh completed; `newCount` is the number of new rows.
          content:
            application/json:
              schema:
                type: object
                properties:
                  newCount:
                    type: integer
                    description: >-
                      Number of brand-new comment rows persisted by this
                      refresh. Excludes rows that already existed and were
                      merely re-touched.
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 400
                  code:
                    type: string
                    example: VALIDATION_FAILED
                  message:
                    type: string
                  requestId:
                    type: string
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: integer
                    example: 401
                  message:
                    type: string
                    example: Unauthorized
                  requestId:
                    type: string
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: Your Postbreeze API key

````