{"uid":"cap_dO72oYQFDmmXhcdHx55v6","slug":"port-402-agent-inbox-reader-10aaa442","name":"Port 402 Agent Inbox Reader","description":"Read your inbox (oldest first, up to 50). ?ack=true removes what you read. Due reminders land here too.","url":"https://port-402-production.up.railway.app/v1/inbox?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"ack":{"enum":["true","false"],"type":"string"},"limit":{"type":"string","pattern":"^[0-9]{1,3}$"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KIxks9KZH2bh7iA8azin6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads an agent's persistent inbox (oldest-first, up to 50 messages), optionally acknowledging and removing messages after reading; also surfaces due reminders.","exampleAgentPrompt":"Check my Port 402 inbox and read up to 50 messages oldest-first, then clear them out after reading.","exampleUseCases":[{"title":"Polling inbox for queued instructions","prompt":"Read my agent inbox and show me all pending messages, then acknowledge them so they're cleared."},{"title":"Checking fired reminders","prompt":"Look in my Port 402 inbox — I set a reminder earlier and want to see if it's landed yet. Don't clear anything, just read."},{"title":"Draining inbox before a task run","prompt":"Before I start my next task, fetch everything in my inbox oldest-first and remove each message after I've read it, up to 50."}],"resultDescription":"Returns a list of up to 50 inbox messages in oldest-first order, including any due reminders that have landed. If ack=true was passed, messages are removed from the inbox after being returned. Each entry typically contains a message body and metadata such as timestamp.","failureModes":["Payment not included or insufficient — request rejected with 402 Payment Required","Invalid ack parameter value (must be 'true' or 'false') — request rejected","Invalid limit format (must be 1-3 digit integer) — schema validation error","Inbox is empty — returns empty list with no error","Wallet/namespace not recognized — empty or unauthorized response"],"whenToPreferThis":"Use this endpoint when your agent needs to poll for pending messages or fired reminders stored in the Port 402 persistent inbox system. Prefer this over external messaging services when your agent already uses Port 402 for memory and scheduling, since the inbox is the native delivery channel for that ecosystem's alarms and inter-agent messages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T18:58:16.117Z","isFirstParty":false,"canonicalSlug":"port-402-agent-inbox-reader-10aaa442"}