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

# Comments overview

> Manage post comments and replies via API v1

## Comments API

Use these endpoints to work with the comment inbox: list threads, **reply** (create with `parent_comment_id`), edit your own comments (`content` / `media` - ids and/or URLs like post `content[].media`), delete, and hide replies on the network when supported.

All routes require the **`posts`** ability and a post in a workspace you can access.

| Method | Path                                                  | Purpose                                                               |
| ------ | ----------------------------------------------------- | --------------------------------------------------------------------- |
| GET    | [`/comments`](/api-reference/comments/list)           | List comments for a post (paginated, optional nested replies)         |
| POST   | [`/comments/sync`](/api-reference/comments/sync)      | Pull comments from networks for **published** platform rows on a post |
| POST   | [`/comments`](/api-reference/comments/create)         | Create comment or **reply**                                           |
| GET    | [`/comments/{id}`](/api-reference/comments/get)       | Get one comment with replies                                          |
| PUT    | [`/comments/{id}`](/api-reference/comments/update)    | Update text and/or media URLs (author only)                           |
| DELETE | [`/comments/{id}`](/api-reference/comments/delete)    | Delete (rules match dashboard)                                        |
| PATCH  | [`/comments/{id}/hide`](/api-reference/comments/hide) | Hide on platform (social replies)                                     |

### Sources & filters

* Query `source` defaults to **`SOCIAL`**. Use **`INTERNAL`** to include internal, approval, and public-share thread comments (same grouping as the UI).
* **`SOCIAL`** + first page: optionally triggers a **sync** from connected networks (same as opening the thread in the app). You can also call **`POST /comments/sync`** with `post_id` to sync on demand.
* Filter with `provider` (platform key), `is_resolved`, `is_approved`, `include_replies`.

### Replies

Set **`parent_comment_id`** on **POST** `/comments`. The API copies `source`, `platform`, `post_id`, and `platform_post_id` from the parent (with the same public-share → internal adjustment as the dashboard).

See also: [Posts - get](/api-reference/posts/get) with `include_comments=true` for comments embedded on a post payload.