Comments
Comment threads on ads, with reactions, attachments and subscriptions.
Edit your comment
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
attachments- Attachments.
body- Text.
expectedVersion- The version you last read. A mismatch is a conflict that returns the current entity.
Response
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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 PATCH "$PLUTO_API/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 4eb7b26a-5068-452f-b23d-121cbda20077" \
-H "Content-Type: application/json" \
-d '{
"attachments": [
{}
],
"body": "Can we try the 4x5 cut for Instagram feed before we publish?",
"expectedVersion": 3
}'Delete a comment
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
expectedVersion | string | Optional | Version. |
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
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 1a2296f1-ba3e-4925-9086-198d4eed0414"Get a comment attachment
Stable link to a comment attachment.
Redirects to a fresh short-lived download URL.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
attachment_id | string | Required | The attachment'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
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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/attachments/2f768d03-7ea0-4ca6-ad4e-7adf9c3214c2" \
-H "Authorization: Bearer $PLUTO_KEY"Add your reaction
Needs a person: API keys and M2M clients get 403; a connected agent or an mcp agent client acts for its person and can.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
emoji | string | Required | |
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
Reactions.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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 PUT "$PLUTO_API/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/reactions/%F0%9F%91%8D" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 33ba0d0c-70df-4e0c-8134-cc6dc58d41c4"Remove your reaction
Needs a person: API keys and M2M clients get 403; a connected agent or an mcp agent client acts for its person and can.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The comment's ID. |
emoji | string | Required | |
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
Reactions.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/reactions/%F0%9F%91%8D" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 44bb6440-6d6a-4006-b306-c7ef01251050"Reopen a thread
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
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/reopen" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 5ae7004b-c133-43c2-837f-6ea0bb7dacda"Resolve a thread
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
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/resolve" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 1852fe5a-3c79-4f68-9c62-f13dde58bc18"Undo deleting a comment
Within an hour of the delete: content, reactions and notifications come back.
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
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/restore" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 02f3ffac-4e1e-4c8d-914e-b23caf5b2b7c"Subscribe to a thread
Needs a person: API keys and M2M clients get 403; a connected agent or an mcp agent client acts for its person and can.
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
subscribed- Follow or not.
Response
Subscription.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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 PUT "$PLUTO_API/comments/65d5adb8-9b81-44dc-9131-33b87d15eb2a/subscription" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: c13d6347-3894-488f-988f-7301b9009186" \
-H "Content-Type: application/json" \
-d '{
"subscribed": true
}'List comment threads on an ad
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_id | string | Required | The ad's ID. |
after | string | Optional | Cursor: nextAfter of the previous page. |
limit | string | Optional | Page size (1-500). |
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
nextAfter- Cursor for the next page; null at the end.
threads- Threads, oldest first.
threads[].adId- Ad.
threads[].attachments- Attachments.
threads[].attachments[].contentType- MIME type.
threads[].attachments[].id- Attachment.
threads[].attachments[].mediaId- Library media, when attached from it.
threads[].attachments[].name- Name.
threads[].attachments[].size- Bytes.
threads[].attachments[].url- Signed download URL (an hour); null in stored command results.
threads[].authorthreads[].author.avatarUrl- Avatar.
threads[].author.id- Their ID.
threads[].author.kind- Who wrote it.One of
person,agent,api_key threads[].author.name- Name.
threads[].author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
threads[].body- Markdown subset with
@[Name](user:<id>)mentions. threads[].createdAt- Posted.
threads[].deleted- Deleted.
threads[].deletedAt- Deleted at.
threads[].editedAt- Last edit.
threads[].id- ID.
threads[].internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
threads[].mentions- Mentioned people.
threads[].parentId- The thread it replies to.
threads[].reactions- Reactions.
threads[].reactions[].count- How many.
threads[].reactions[].emoji- Emoji.
threads[].reactions[].userIds- Who.
threads[].resolved- Thread resolved.
threads[].resolvedAt- Resolved at.
threads[].resolvedBy- Who resolved it.
threads[].version- Increments on every change; send as
expectedVersion. threads[].replies- Replies in order.
threads[].replies[].adId- Ad.
threads[].replies[].attachments- Attachments.
threads[].replies[].attachments[].contentType- MIME type.
threads[].replies[].attachments[].id- Attachment.
threads[].replies[].attachments[].mediaId- Library media, when attached from it.
threads[].replies[].attachments[].name- Name.
threads[].replies[].attachments[].size- Bytes.
threads[].replies[].attachments[].url- Signed download URL (an hour); null in stored command results.
threads[].replies[].authorthreads[].replies[].author.avatarUrl- Avatar.
threads[].replies[].author.id- Their ID.
threads[].replies[].author.kind- Who wrote it.One of
person,agent,api_key threads[].replies[].author.name- Name.
threads[].replies[].author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
threads[].replies[].body- Markdown subset with
@[Name](user:<id>)mentions. threads[].replies[].createdAt- Posted.
threads[].replies[].deleted- Deleted.
threads[].replies[].deletedAt- Deleted at.
threads[].replies[].editedAt- Last edit.
threads[].replies[].id- ID.
threads[].replies[].internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
threads[].replies[].mentions- Mentioned people.
threads[].replies[].parentId- The thread it replies to.
threads[].replies[].reactions- Reactions.
threads[].replies[].reactions[].count- How many.
threads[].replies[].reactions[].emoji- Emoji.
threads[].replies[].reactions[].userIds- Who.
threads[].replies[].resolved- Thread resolved.
threads[].replies[].resolvedAt- Resolved at.
threads[].replies[].resolvedBy- Who resolved it.
threads[].replies[].version- Increments on every change; send as
expectedVersion. threads[].subscribed- Whether the reader follows the thread.
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/ads/a96d7456-dc02-4734-998b-3e439361abe3/comments" \
-H "Authorization: Bearer $PLUTO_KEY"Comment on an ad
People, agents and API keys comment as themselves: author.kind is person, agent or api_key. Who sees a comment follows its launch: guests read every comment on a launch shared with them, and none on any other.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_id | string | Required | The ad'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
attachments- Attachments.
body- Text; @mentions notify.
id- Optional ID.
parentId- Reply to a thread.
Response
adId- Ad.
attachments- Attachments.
attachments[].contentType- MIME type.
attachments[].id- Attachment.
attachments[].mediaId- Library media, when attached from it.
attachments[].name- Name.
attachments[].size- Bytes.
attachments[].url- Signed download URL (an hour); null in stored command results.
authorauthor.avatarUrl- Avatar.
author.id- Their ID.
author.kind- Who wrote it.One of
person,agent,api_key author.name- Name.
author.userId- The person behind it (the author, or the person an agent acts for); null for an API key.
body- Markdown subset with
@[Name](user:<id>)mentions. createdAt- Posted.
deleted- Deleted.
deletedAt- Deleted at.
editedAt- Last edit.
id- ID.
internal- Hidden from guests: a thread kept from guests before guest access became per launch; guests never see it, its replies or reactions. Read only: no thread becomes hidden any more.
mentions- Mentioned people.
parentId- The thread it replies to.
reactions- Reactions.
reactions[].count- How many.
reactions[].emoji- Emoji.
reactions[].userIds- Who.
resolved- Thread resolved.
resolvedAt- Resolved at.
resolvedBy- Who resolved it.
version- Increments on every change; send as
expectedVersion.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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/ads/a96d7456-dc02-4734-998b-3e439361abe3/comments" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 74e052e4-4ecd-48be-8cb4-e9264c7c3ec5" \
-H "Content-Type: application/json" \
-d '{
"attachments": [
{}
],
"body": "Can we try the 4x5 cut for Instagram feed before we publish?",
"id": "a96d7456-dc02-4734-998b-3e439361abe3",
"parentId": "7c19c95a-2160-43ed-9554-9d8b7f4bf5a4"
}'List activity on an ad
Changes and comment threads, oldest first. Page forward with after, or back from an entry you have with before (its ID): the page just before it, still oldest first, with nextBefore to go further back (null at the ad's first entry).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_id | string | Required | The ad's ID. |
after | string | Optional | Cursor: nextAfter of the previous page. |
before | string | Optional | The ID of an entry (a change, or a thread's first comment): the entries just before it. Not with after. |
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
items- This page, oldest first.
nextAfter- Cursor for the next page; null at the end, and with
before. nextBefore- With
before: pass asbeforefor the entries before this page; null at the ad's first entry.
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/ads/a96d7456-dc02-4734-998b-3e439361abe3/activity" \
-H "Authorization: Bearer $PLUTO_KEY"Get an ad's subscribers
Needs a person: API keys and M2M clients get 403; a connected agent or an mcp agent client acts for its person and can.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_id | string | Required | The ad'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
subscribed and followers.
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/ads/a96d7456-dc02-4734-998b-3e439361abe3/subscription" \
-H "Authorization: Bearer $PLUTO_KEY"Subscribe to an ad
Needs a person: API keys and M2M clients get 403; a connected agent or an mcp agent client acts for its person and can.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ad_id | string | Required | The ad'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
subscribed- Follow or not.
Response
Subscription.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another workspace.
- 404Not found in this workspace.
- 409Conflict: a stale
expectedVersion(the body carriescurrent), a duplicate, or an Idempotency-Key reused with different input. - 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 PUT "$PLUTO_API/ads/a96d7456-dc02-4734-998b-3e439361abe3/subscription" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 342cec49-24e8-48a0-948a-514338dd0f42" \
-H "Content-Type: application/json" \
-d '{
"subscribed": true
}'