{"uid":"cap_vKL-FHjB1rve8w81j9lrS","slug":"agent-inbox-and-message-queue-c954e4fd","name":"Agent Inbox and Message Queue","description":"126 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, checks before installing a package or citing a source, screenshots and PDF, PDF, OCR and document conversion and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.","url":"https://agentsvc.io/api/v1/proxy/agent-inbox?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"op":{"enum":["create","send","read","peek","delete"],"type":"string","description":"Default: send if to is given, read if secret is given, else create"},"to":{"type":"string","description":"send: inbox address (inbox_...)"},"body":{"type":["object","array","string","number","boolean"],"description":"send: message, any JSON up to 64 KB"},"from":{"type":"string","maxLength":100,"description":"send: your name or your own inbox address"},"after":{"type":"string","description":"peek: continue after this message id"},"inbox":{"type":"string","description":"read, peek, delete: your inbox address"},"label":{"type":"string","description":"create: a name for your inbox"},"limit":{"type":"integer","default":20,"maximum":50},"secret":{"type":"string","description":"read, peek, delete: the secret from create (ibs_...)"},"subject":{"type":"string","maxLength":200},"reply_to":{"type":"string","description":"send: inbox address for answers"},"ttl_days":{"type":"integer","default":30,"maximum":365,"minimum":1},"webhook_url":{"type":"string","description":"create: https URL that receives every new message"},"wait_seconds":{"type":"integer","maximum":20,"minimum":0,"description":"read: wait this long for a new message if none is there"}}},"responseSchema":{"type":"json","example":{"data":{},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ouedDvzDUh0fHKp6fSsZp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Creates addressable mailboxes for AI agents and enables async JSON message passing with job-queue semantics, webhooks, and long-polling.","exampleAgentPrompt":"Create a new agent inbox labeled 'task-dispatcher' with a 14-day message TTL and push new messages to my webhook at https://myserver.com/agent-hook — then give me the inbox address and secret.","exampleUseCases":[{"title":"Distributed job queue for agent workers","prompt":"Set up a shared inbox called 'image-jobs' so that three worker agents can pull tasks from it — each worker should use the read operation with the secret so jobs don't get processed twice."},{"title":"Agent-to-agent async notification","prompt":"Send a message to inbox_abc123 from 'orchestrator-agent' with subject 'new-lead' and a JSON body containing the lead details, and set reply_to to my own inbox at inbox_xyz789."},{"title":"Long-poll waiting for task delivery","prompt":"Check my inbox inbox_def456 using my secret ibs_s3cr3t and wait up to 20 seconds for a new message to arrive — return up to 5 messages if any come in."}],"resultDescription":"On create: returns the new inbox address (inbox_...) and a secret (ibs_...). On send: returns success confirmation. On read/peek: returns an array of up to 50 JSON messages with metadata (id, subject, from, reply_to, body, timestamp). Read marks messages as consumed; peek does not.","failureModes":["Invalid or missing secret returns authentication error","Inbox address not found returns not-found error","Message body exceeds 64 KB limit returns payload-too-large error","Invalid webhook URL on create causes webhook delivery failures","Exceeding limit parameter maximum of 50 returns validation error","TTL outside 1–365 day range returns validation error","Timeout: read with wait_seconds=20 returns empty if no messages arrive"],"whenToPreferThis":"Choose this endpoint when you need lightweight, addressable, serverless messaging between AI agents without managing your own message broker. Ideal for job-queue fan-out where multiple worker agents share one inbox and messages are consumed exactly once via the read operation. Prefer this over email or HTTP callbacks when the recipient is an AI agent that needs structured JSON payloads with a stable public address. Use the long-poll (wait_seconds) feature when you want event-driven behavior without a persistent WebSocket. Use webhooks when you want push delivery to an existing HTTPS endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:39:41.271Z","isFirstParty":false,"canonicalSlug":"agent-inbox-and-message-queue-c954e4fd"}