Comments API
Use these endpoints to work with the comment inbox: list threads, reply (create withparent_comment_id), edit your own comments (content / media_urls), 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 | List comments for a post (paginated, optional nested replies) |
| POST | /comments/sync | Pull comments from networks for published platform rows on a post |
| POST | /comments | Create comment or reply |
| GET | /comments/{id} | Get one comment with replies |
| PUT | /comments/{id} | Update text and/or media URLs (author only) |
| DELETE | /comments/{id} | Delete (rules match dashboard) |
| PATCH | /comments/{id}/hide | Hide on platform (social replies) |
Sources & filters
- Query
sourcedefaults toSOCIAL. UseINTERNALto 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 callPOST /comments/syncwithpost_idto sync on demand.- Filter with
provider(platform key),is_resolved,is_approved,include_replies.
Replies
Setparent_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 with include_comments=true for comments embedded on a post payload.