Post comments
Comments on your ads' Facebook and Instagram posts: read, reply, hide and delete.
List comments on your ads
Top-level comments by other people on the posts your ads run as, newest first, each with its replies, the ad it's on, who in Pluto replied or moderated it, and actions waiting for the platform. Without platform: Meta's (Facebook Page posts and Instagram media); another platform's whose capabilities.comments is on (GET /platforms) come in its own shape, with member data null and redacted: true where its terms keep it in the app, and may take fewer filters. access says which platforms are read, which permissions are missing and when comments were last read. Keyset-paged: pass nextAfter as after.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
platform | string | Optional | facebook or instagram for one of Meta's, or a platform from GET /platforms. |
hidden | string | Optional | true: only hidden comments; false: only visible ones. |
unanswered | string | Optional | true: only comments the brand hasn't replied to. |
unread | string | Optional | true: only comments on posts unread for you (postUnread). Needs a credential that acts for a person. |
followUp | string | Optional | true: only comments on posts your team follows up (postFollowUp); false: only the others. |
done | string | Optional | true: only comments on posts in your team's Done (postDone); false: only the inbox. |
adId | string | Optional | The ad's ID on its platform: only comments on the posts this ad runs as. |
postId | string | Optional | The post's ID on its platform (on Meta a post or media ID). |
search | string | Optional | Part of the text or the author's name. |
after | string | Optional | Cursor: nextAfter from the previous page. |
limit | string | Optional | Page size (1-200, default 50). |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
accessaccess.failingPosts- Posts whose last read failed.
access.lastError- Why one of them failed.
access.missingPermissions- Grant these by reconnecting Meta.
access.platforms- Platforms whose comments are read.
access.posts- Posts of ads whose comments are read.
access.readAt- Comments were last read to the end.
access.statusready: both platforms;partial: one lacks permissions.One ofready,partial,missing_permissions,reauthorize,disconnectedaccess.syncJobId- The read in progress.
access.webhookPages- Pages that push comment changes; the rest are read every few minutes.
items- This page.
items[].accountitems[].account.instagramAccountId- Instagram account (Instagram comments).
items[].account.instagramUsername- Instagram username.
items[].account.pageId- Facebook Page.
items[].account.pageName- Page name.
items[].ad- The ad the post runs as.
items[].ad.adAccountId- act_…
items[].ad.ads- Ads that run as this post.
items[].ad.id- Meta ad ID.
items[].ad.launchId- The Pluto launch that manages the ad.
items[].ad.name- Ad name.
items[].ad.thumbnailUrl- Meta-hosted preview.
items[].answered- Your Page or Instagram account replied in the thread.
items[].answeredAt- Latest reply by your Page or Instagram account.
items[].authoritems[].author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
items[].author.name- Facebook name or Instagram username; null when Meta doesn't share it.
items[].author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
items[].byPage- Written by your Page or Instagram account.
items[].canDelete- Deleting is possible now.
items[].canHide- Hiding (or unhiding) is possible now.
items[].canLike- Liking it, or taking the like back, is possible now (Facebook only).
items[].canReply- A reply is possible now.
items[].createdTime- Posted.
items[].failed- The latest action, when it failed.
items[].failed.actoritems[].failed.actor.id- Person, API key or agent client.
items[].failed.actor.kind- Actor kind.One of
person,api_key,agent,system items[].failed.actor.name- Name at the time.
items[].failed.createdAt- Asked.
items[].failed.error- Why it failed, for the person or agent.
items[].failed.finishedAt- Meta confirmed or refused.
items[].failed.id- Action.
items[].failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). items[].failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment items[].failed.message- The reply's text (replies).
items[].failed.statuspendinguntil Meta confirms.One ofpending,succeeded,faileditems[].hidden- Hidden.
items[].id- Comment (Pluto ID).
items[].likeCount- Likes, when Meta reports them.
items[].liked- Your Page likes it (Facebook).
items[].message- Text; empty for a sticker or image only.
items[].metaId- Meta's comment ID.
items[].moderated- Who in Pluto last hid, unhid or deleted it.
items[].moderated.at- When.
items[].moderated.byitems[].moderated.by.id- Person, API key or agent client.
items[].moderated.by.kind- Actor kind.One of
person,api_key,agent,system items[].moderated.by.name- Name at the time.
items[].parentMetaId- The top-level comment's Meta ID (replies).
items[].pending- Actions waiting for Meta.
items[].pending[].actoritems[].pending[].actor.id- Person, API key or agent client.
items[].pending[].actor.kind- Actor kind.One of
person,api_key,agent,system items[].pending[].actor.name- Name at the time.
items[].pending[].createdAt- Asked.
items[].pending[].error- Why it failed, for the person or agent.
items[].pending[].finishedAt- Meta confirmed or refused.
items[].pending[].id- Action.
items[].pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). items[].pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment items[].pending[].message- The reply's text (replies).
items[].pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,faileditems[].permalinkUrl- Link to the comment on Facebook.
items[].platform- Platform.One of
facebook,instagram items[].postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
items[].postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). items[].postId- Meta's post (Facebook) or media (Instagram) ID.
items[].postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. items[].replies- Replies, oldest first (top-level comments).
items[].sentBy- Who sent it through Pluto (replies).
items[].sentBy.id- Person, API key or agent client.
items[].sentBy.kind- Actor kind.One of
person,api_key,agent,system items[].sentBy.name- Name at the time.
items[].version- Increments when Meta or Pluto changes it.
nextAfter- Cursor for the next page; null at the end.
curl "$PLUTO_API/social/comments" \
-H "Authorization: Bearer $PLUTO_KEY"Read comments now
Reads the comments on the ads' posts from the platform now (platform; without it, Meta's) instead of at the next scheduled read (every few minutes for delivering ads; webhooks push changes sooner when set up). On Meta: the posts of delivering ads first, then the most recently commented and the newest, at most 30, so the read takes seconds; narrow it to one Page, ad or post with the body. A platform that reads every ad post's comments together takes no filter. Returns the read job (a new one, or the same read already under way, which then also covers this request); follow it with GET /jobs/{id}, then list the comments. Without a filter, the background read of every post follows too (fullReadJobId), which covers the posts of ads that stopped delivering and can take minutes in a large workspace.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
adId- Only the posts this Meta ad runs as.
pageId- Only the posts of this Facebook Page (Meta ID; its Instagram media too).
platform- A platform from
GET /platforms: read that platform's comments (every ad post's, no filter). Without it: Meta's. postId- Only this Facebook post or Instagram media (Meta ID).
Response
fullReadJobId- Without a filter: the background read of every post.
jobId- The read of the asked posts.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 409The platform isn't connected, or the connection lacks the comment permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/sync" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 7eeb3ee7-9e9e-49cf-b173-c721bfbe4e8a" \
-H "Content-Type: application/json" \
-d '{
"adId": "120288304425086360",
"pageId": "229657833239852",
"platform": "Brevanne",
"postId": "229657833239852_6189168736088973"
}'Get a comment
One comment with its replies (a reply comes without replies of its own), the ad it's on and pending actions. Deleted comments are 404.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
accountaccount.instagramAccountId- Instagram account (Instagram comments).
account.instagramUsername- Instagram username.
account.pageId- Facebook Page.
account.pageName- Page name.
ad- The ad the post runs as.
ad.adAccountId- act_…
ad.ads- Ads that run as this post.
ad.id- Meta ad ID.
ad.launchId- The Pluto launch that manages the ad.
ad.name- Ad name.
ad.thumbnailUrl- Meta-hosted preview.
answered- Your Page or Instagram account replied in the thread.
answeredAt- Latest reply by your Page or Instagram account.
authorauthor.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
author.name- Facebook name or Instagram username; null when Meta doesn't share it.
author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
byPage- Written by your Page or Instagram account.
canDelete- Deleting is possible now.
canHide- Hiding (or unhiding) is possible now.
canLike- Liking it, or taking the like back, is possible now (Facebook only).
canReply- A reply is possible now.
createdTime- Posted.
failed- The latest action, when it failed.
failed.actorfailed.actor.id- Person, API key or agent client.
failed.actor.kind- Actor kind.One of
person,api_key,agent,system failed.actor.name- Name at the time.
failed.createdAt- Asked.
failed.error- Why it failed, for the person or agent.
failed.finishedAt- Meta confirmed or refused.
failed.id- Action.
failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment failed.message- The reply's text (replies).
failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedhidden- Hidden.
id- Comment (Pluto ID).
likeCount- Likes, when Meta reports them.
liked- Your Page likes it (Facebook).
message- Text; empty for a sticker or image only.
metaId- Meta's comment ID.
moderated- Who in Pluto last hid, unhid or deleted it.
moderated.at- When.
moderated.bymoderated.by.id- Person, API key or agent client.
moderated.by.kind- Actor kind.One of
person,api_key,agent,system moderated.by.name- Name at the time.
parentMetaId- The top-level comment's Meta ID (replies).
pending- Actions waiting for Meta.
pending[].actorpending[].actor.id- Person, API key or agent client.
pending[].actor.kind- Actor kind.One of
person,api_key,agent,system pending[].actor.name- Name at the time.
pending[].createdAt- Asked.
pending[].error- Why it failed, for the person or agent.
pending[].finishedAt- Meta confirmed or refused.
pending[].id- Action.
pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment pending[].message- The reply's text (replies).
pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedpermalinkUrl- Link to the comment on Facebook.
platform- Platform.One of
facebook,instagram postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). postId- Meta's post (Facebook) or media (Instagram) ID.
postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. replies- Replies, oldest first (top-level comments).
sentBy- Who sent it through Pluto (replies).
sentBy.id- Person, API key or agent client.
sentBy.kind- Actor kind.One of
person,api_key,agent,system sentBy.name- Name at the time.
version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl "$PLUTO_API/social/comments/6189168736088973_5097997344671361" \
-H "Authorization: Bearer $PLUTO_KEY"Delete a comment
Deletes the comment and its replies at its platform. This can't be undone: confirm with the person first (MCP's delete_social_comment requires confirm: true). 202 with the queued action.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Already being deleted, the platform doesn't allow deleting it, or the connection lacks the permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X DELETE "$PLUTO_API/social/comments/6189168736088973_5097997344671361" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 504a1d48-68da-42f1-aa94-ca4d6db37213"Hide a comment
Hides the comment: its author (and your Page's admins) still see it, nobody else does. The brand's own comments can't be hidden. Only where the platform hides comments (capabilities.commentHide on GET /platforms; refused elsewhere). 202 with the queued action, or 200 with action: null when it already is hidden.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Deleted, another hide, unhide or delete is still pending, the platform doesn't allow hiding it, or the connection lacks the permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/6189168736088973_5097997344671361/hide" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: ab45a03e-8ccb-400a-8726-6d73f8dca901"Add a like to a comment
Likes the comment as your Page, as Meta Business Suite's Like does. Facebook comments only: Instagram takes no likes through its API, and no other platform takes them through Pluto. 202 with the queued action, or 200 with action: null when your Page already likes it; Meta usually confirms within seconds.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Deleted, being deleted, not a Facebook comment, or the connection lacks the permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/6189168736088973_5097997344671361/like" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 545b2f89-b70c-43b8-a8d8-a5b1e802b549"Reply to a comment
Replies publicly as the brand (on Meta the Page or the Instagram account), in the comment's thread (a reply to a reply goes to the thread's top-level comment, as on Meta). Instagram doesn't take replies to hidden comments. A platform whose terms don't let AI write replies (policy.aiCommentReplies: false on GET /platforms) takes a reply only from a person in the app. Returns 202 with the queued action; the platform usually confirms within seconds, and the reply then appears in the thread attributed to you. Up to 2,200 characters.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Request body
message- The reply, 1-2,200 characters.
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Deleted, being deleted, an Instagram comment that is hidden, or the connection lacks the permissions (on Meta
reason: meta_permissions,missingPermissions). - 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/6189168736088973_5097997344671361/replies" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 13615b29-2c20-45e8-9a6e-e9d64aba7bce" \
-H "Content-Type: application/json" \
-d '{
"message": "Can we try the 4x5 cut for Instagram feed before we publish?"
}'Unhide a comment
Shows a hidden comment again, where the platform hides comments (capabilities.commentHide). 202 with the queued action, or 200 with action: null when it already is visible.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Deleted, another hide, unhide or delete is still pending, or the connection lacks the permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/6189168736088973_5097997344671361/unhide" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: beb17038-1964-4339-8508-a228d10d1f79"Take back a like
Takes your Page's like off the comment (Facebook only). 202 with the queued action, or 200 with action: null when your Page doesn't like it.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
Idempotency-Key | string | Optional | The command ID. A retry with the same key returns the stored result; the same key with different input is a 409. Without it a retry cannot be recognized. |
Pluto-Workspace | string (uuid) | Optional | The workspace to act in, for credentials that can reach several (sessions, agent tokens). API keys belong to one workspace; another value is a 403. |
Response
action- The queued action; null when the comment already was in that state.
action.actoraction.actor.id- Person, API key or agent client.
action.actor.kind- Actor kind.One of
person,api_key,agent,system action.actor.name- Name at the time.
action.createdAt- Asked.
action.error- Why it failed, for the person or agent.
action.finishedAt- Meta confirmed or refused.
action.id- Action.
action.jobId- The job that sends it to Meta (
GET /jobs/{id}). action.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment action.message- The reply's text (replies).
action.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcommentcomment.accountcomment.account.instagramAccountId- Instagram account (Instagram comments).
comment.account.instagramUsername- Instagram username.
comment.account.pageId- Facebook Page.
comment.account.pageName- Page name.
comment.ad- The ad the post runs as.
comment.ad.adAccountId- act_…
comment.ad.ads- Ads that run as this post.
comment.ad.id- Meta ad ID.
comment.ad.launchId- The Pluto launch that manages the ad.
comment.ad.name- Ad name.
comment.ad.thumbnailUrl- Meta-hosted preview.
comment.answered- Your Page or Instagram account replied in the thread.
comment.answeredAt- Latest reply by your Page or Instagram account.
comment.authorcomment.author.id- Meta's (app-scoped) ID; null when Meta doesn't share it.
comment.author.name- Facebook name or Instagram username; null when Meta doesn't share it.
comment.author.picture- Facebook profile picture (https, Meta's CDN); null when Meta doesn't share it, and always on Instagram.
comment.byPage- Written by your Page or Instagram account.
comment.canDelete- Deleting is possible now.
comment.canHide- Hiding (or unhiding) is possible now.
comment.canLike- Liking it, or taking the like back, is possible now (Facebook only).
comment.canReply- A reply is possible now.
comment.createdTime- Posted.
comment.failed- The latest action, when it failed.
comment.failed.actorcomment.failed.actor.id- Person, API key or agent client.
comment.failed.actor.kind- Actor kind.One of
person,api_key,agent,system comment.failed.actor.name- Name at the time.
comment.failed.createdAt- Asked.
comment.failed.error- Why it failed, for the person or agent.
comment.failed.finishedAt- Meta confirmed or refused.
comment.failed.id- Action.
comment.failed.jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.failed.kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.failed.message- The reply's text (replies).
comment.failed.statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.hidden- Hidden.
comment.id- Comment (Pluto ID).
comment.likeCount- Likes, when Meta reports them.
comment.liked- Your Page likes it (Facebook).
comment.message- Text; empty for a sticker or image only.
comment.metaId- Meta's comment ID.
comment.moderated- Who in Pluto last hid, unhid or deleted it.
comment.moderated.at- When.
comment.moderated.bycomment.moderated.by.id- Person, API key or agent client.
comment.moderated.by.kind- Actor kind.One of
person,api_key,agent,system comment.moderated.by.name- Name at the time.
comment.parentMetaId- The top-level comment's Meta ID (replies).
comment.pending- Actions waiting for Meta.
comment.pending[].actorcomment.pending[].actor.id- Person, API key or agent client.
comment.pending[].actor.kind- Actor kind.One of
person,api_key,agent,system comment.pending[].actor.name- Name at the time.
comment.pending[].createdAt- Asked.
comment.pending[].error- Why it failed, for the person or agent.
comment.pending[].finishedAt- Meta confirmed or refused.
comment.pending[].id- Action.
comment.pending[].jobId- The job that sends it to Meta (
GET /jobs/{id}). comment.pending[].kind- What was asked.One of
reply,hide,unhide,delete,like,unlike,comment comment.pending[].message- The reply's text (replies).
comment.pending[].statuspendinguntil Meta confirms.One ofpending,succeeded,failedcomment.permalinkUrl- Link to the comment on Facebook.
comment.platform- Platform.One of
facebook,instagram comment.postDone- Its post is in your team's Done: moved there, with no comment by someone other than your brand since.
comment.postFollowUp- Your team follows up its post (
POST /social/posts/{platform}/{id}/state). comment.postId- Meta's post (Facebook) or media (Instagram) ID.
comment.postUnread- Its post has a comment by someone other than the brand that you haven't read: unread until you open the thread (
POST /social/posts/{platform}/{id}/read), and again once someone comments after that. Your own; null for a credential that acts for no person. comment.replies- Replies, oldest first (top-level comments).
comment.sentBy- Who sent it through Pluto (replies).
comment.sentBy.id- Person, API key or agent client.
comment.sentBy.kind- Actor kind.One of
person,api_key,agent,system comment.sentBy.name- Name at the time.
comment.version- Increments when Meta or Pluto changes it.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Deleted, being deleted, not a Facebook comment, or the connection lacks the permissions.
- 422Validation failed;
errorslists every field problem at once. - 429Too many requests from this credential. Wait
Retry-Afterseconds. People in the app have their own budget, so an agent swarm can't starve them.
curl -X POST "$PLUTO_API/social/comments/6189168736088973_5097997344671361/unlike" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: d656b322-a1b1-4f52-be40-05d037b67766"