Inbox
Your notifications: read, archive and snooze them.
List your inbox
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 |
|---|---|---|---|
kind | string | Optional | Kinds. |
notKind | string | Optional | Exclude kinds. |
from | string | Optional | Actors. |
notFrom | string | Optional | Exclude actors. |
launch | string | Optional | Launches. |
notLaunch | string | Optional | Exclude launches. |
status | string | Optional | Statuses. |
notStatus | string | Optional | Exclude statuses. |
unread | string | Optional | Unread only. |
snoozed | string | Optional | Snoozed. |
grouped | string | Optional | Group by ad. |
order | string | Optional | newest (default) or oldest first, over every page; a cursor belongs to its order. |
after | string | Optional | Cursor. |
limit | string | Optional | Page size. |
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.
nextAfter- Cursor for the next page; null at the end.
curl "$PLUTO_API/inbox" \
-H "Authorization: Bearer $PLUTO_KEY"Archive notifications
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 |
|---|---|---|---|
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
ids- IDs.
Response
Updated count.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another 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/inbox/archive" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 6470ef34-144a-437e-b81e-ccccc2fc7d03" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"b0182a4d-a8af-42b8-9fa8-fabdbd2b5ddc"
]
}'Mark read
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 |
|---|---|---|---|
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
all- Everything.
ids- IDs.
Response
Updated count.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another 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/inbox/read" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: ebfc1826-5ad7-47b2-85b1-0410923f5222" \
-H "Content-Type: application/json" \
-d '{
"all": true,
"ids": [
"b0182a4d-a8af-42b8-9fa8-fabdbd2b5ddc"
]
}'Snooze notifications
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 |
|---|---|---|---|
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
ids- IDs.
until- Until.
Response
Updated count.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another 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/inbox/snooze" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: f6c8fd11-5ee1-44ba-9327-96b9799506de" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"b0182a4d-a8af-42b8-9fa8-fabdbd2b5ddc"
],
"until": "2026-09-30T13:00:00Z"
}'Unarchive notifications
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 |
|---|---|---|---|
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
ids- IDs.
Response
Updated count.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another 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/inbox/unarchive" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 24c48ead-5698-42da-b91d-ef15ff954b5e" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"b0182a4d-a8af-42b8-9fa8-fabdbd2b5ddc"
]
}'Mark unread
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 |
|---|---|---|---|
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
ids- IDs.
Response
Updated count.
Errors
- 400The request is malformed.
- 401No valid credential.
- 403The credential lacks the permission, or belongs to another 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/inbox/unread" \
-H "Authorization: Bearer $PLUTO_KEY" \
-H "Idempotency-Key: 3ebb5cf5-87f5-40fd-bfc2-77636a36bd5d" \
-H "Content-Type: application/json" \
-d '{
"ids": [
"b0182a4d-a8af-42b8-9fa8-fabdbd2b5ddc"
]
}'Count unread notifications
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 |
|---|---|---|---|
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
Counts.
curl "$PLUTO_API/inbox/unread-count" \
-H "Authorization: Bearer $PLUTO_KEY"