{"uid":"cap_gXQ6DOkDh4ASHYHpJUkSf","slug":"a2a-callback-mailbox-agent-capability-foundry-43841455","name":"A2A Callback Mailbox — Agent Capability Foundry","description":"Machine-payable capabilities for autonomous agents. This service accepts A2A callback payloads but is not itself an A2A protocol server and does not publish an A2A Agent Card.","url":"https://callbacks.inversolabs.us/v1/services/agent-callback-mailbox/invoke","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxBytes":{"type":"integer","maximum":4194304,"minimum":65536},"maxEvents":{"type":"integer","maximum":1000,"minimum":1},"ttlMinutes":{"type":"integer","maximum":1440,"minimum":1},"expectedTaskId":{"type":"string","maxLength":256,"minLength":1},"ingressCredential":{"type":"string","maxLength":256,"minLength":32},"retrievalCredential":{"type":"string","maxLength":256,"minLength":32}}},"responseSchema":{"type":"json","example":{"max_bytes":1048576,"expires_at":"2026-08-20T14:00:00+00:00","mailbox_id":"example-mailbox-id","max_events":100,"callback_url":"https://callbacks.inversolabs.us/callbacks/example-mailbox-id","authentication_scheme":"Bearer"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_e_hzJN1btG7jMtBL1ZSPn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions a temporary, machine-payable callback mailbox that accepts A2A callback payloads from remote agents and holds them for retrieval.","exampleAgentPrompt":"Create a callback mailbox that can hold up to 100 events and 1 MB of data, expires in 60 minutes, and is locked to task ID 'task-abc-123' — I'll use the returned callback_url to hand off to a subagent.","exampleUseCases":[{"title":"Async subagent result collection","prompt":"Spin up a callback mailbox that accepts up to 50 events, allows up to 512 KB of data, and expires in 30 minutes so my subagent fleet can POST their results back after finishing their tasks."},{"title":"Multi-step pipeline handoff inbox","prompt":"I'm kicking off a long-running agent task with ID 'pipeline-run-9871' — provision a mailbox for it that stays open for 90 minutes and can hold up to 200 events, so the downstream agent can report back when it's done."},{"title":"Short-lived agent webhook for testing","prompt":"Create a temporary callback mailbox that expires in 5 minutes and holds at most 10 events and 65 KB — I just need it to test whether my orchestrator correctly posts completion payloads to an A2A callback URL."}],"resultDescription":"Returns a JSON object containing the provisioned mailbox_id, a callback_url (the endpoint remote agents should POST to), an expires_at timestamp, the configured max_bytes and max_events limits, and the authentication_scheme (Bearer) used to secure ingress and retrieval.","failureModes":["Invalid parameter ranges (e.g. maxBytes below 65536 or above 4194304, ttlMinutes above 1440) return a 400 validation error","Missing or malformed ingressCredential or retrievalCredential (must be 32–256 chars) returns 400","Payment not included or insufficient USDC payment returns 402 Payment Required","Service unavailability or provisioning failure returns 503","Expired mailbox_id used for subsequent retrieval returns 404"],"whenToPreferThis":"Use this endpoint when you need a short-lived, machine-payable callback inbox without operating your own server — ideal for multi-agent pipelines where a coordinator must receive async results from subagents via a known URL. Prefer this over webhooks or polling when you need a disposable, authenticated ingress point with configurable TTL, event caps, and byte limits, especially in x402-native payment environments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:34.030Z","isFirstParty":false}