{"uid":"cap_N5GysXBA6rvfR1f8H82PO","slug":"agent-exec-handoff-pay-per-use-agent-briefing-storage-1e3eabb2","name":"Agent-Exec Handoff — Pay-Per-Use Agent Briefing Storage","description":"Accountless, pay-per-use code execution for software agents: submit source code, get stdout, stderr and exit code back from an isolated, network-less sandbox. No account, no API key -- possession of valid payment is sufficient.","url":"https://agent-exec.448c.net/handoff?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["done","notDone","inFlight","pickUpFirst"],"properties":{"done":{"type":"array","description":"What is DONE. EVERY entry must have confidence 'measured' with non-null evidence -- a briefing cannot claim something is finished on unverified intent. Violating this is a free 400 (HANDOFF_DONE_REQUIRES_MEASURED), not a silent acceptance."},"notDone":{"type":"array","description":"What is NOT done. May be measured or unverified."},"inFlight":{"type":"array","description":"What was IN FLIGHT at the cut -- neither finished nor abandoned. May be measured or unverified."},"pickUpFirst":{"type":"string","description":"What the successor should do FIRST. Mandatory and non-empty: a briefing with no next action is not a handoff."}}},"responseSchema":{"type":"object","required":["id","expiresAt","payment"],"properties":{"id":{"type":"string","format":"uuid","description":"The handoff_id -- give this to the successor; it needs nothing else."},"payment":{"type":"object","properties":{"asset":{"type":"string"},"payer":{"type":"string","description":"The paying wallet's address."},"amount":{"type":"string","description":"Atomic units of the settlement asset that were charged."},"network":{"type":"string"},"transaction":{"type":"string","description":"On-chain settlement transaction hash."}}},"expiresAt":{"type":"integer","description":"Unix ms this briefing is swept. GET /handoff/{id} answers 410 between the deadline and the sweep, then 404."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0053","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.0053/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0053","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0053","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YAsVg6ZC1wtfkUSJ3lBv3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0053","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a structured agent handoff briefing (done/not-done/in-flight state plus next action) and returns a UUID that a successor agent can use to resume work, billed per-call via x402 micropayment with no account required.","exampleAgentPrompt":"Store a handoff briefing for the next agent: done = ['scraped product catalog (measured: 4,200 rows saved to S3)'], not done = ['enrich prices with competitor data'], in flight = ['deduplication job started at 14:02 UTC'], and tell the successor to start by verifying the deduplication results.","exampleUseCases":[{"title":"Chaining agents across a long research task","prompt":"Create a handoff for the next agent: we've finished scraping all 50 conference websites (verified: 50 JSON files in the output bucket), haven't started the speaker deduplication yet, and the email normalizer is still running. Tell the successor to wait for the normalizer to finish before doing anything else."},{"title":"Overnight agent shift handover","prompt":"I need to hand off to the morning agent — mark 'database backup' as done (evidence: backup log shows 3.2 GB written at 02:14 UTC), leave 'send summary report' as not done, and set pickUpFirst to 'send the daily summary email to the ops team'."},{"title":"Parallel agent task splitting","prompt":"Save a handoff briefing: nothing is done yet, the task 'scrape EU pricing data' is in-flight (started 5 minutes ago), and the successor should pick up by checking whether the scraper finished and then merging its output with the existing US pricing spreadsheet."}],"resultDescription":"Returns a JSON object with a UUID handoff_id (share this with the successor agent — it needs nothing else to retrieve the briefing), an expiresAt Unix millisecond timestamp after which the briefing is swept and returns 410 then 404, and a payment object containing the asset, payer wallet address, amount in atomic units, network, and on-chain transaction hash confirming the x402 micropayment.","failureModes":["400 HANDOFF_DONE_REQUIRES_MEASURED — a 'done' entry lacks confidence='measured' or has null evidence; fix by ensuring every done item has verified, non-null evidence","400 validation error — pickUpFirst is empty or missing; every handoff must specify a concrete next action","402 Payment Required — x402 payment not attached or payment insufficient; agent must attach valid USDC payment","410 Gone — handoff_id exists but briefing has passed its expiry deadline and is pending sweep","404 Not Found — handoff_id never existed or has been fully swept after expiry"],"whenToPreferThis":"Use this endpoint when you need to persist agent state between two agent instances or across a context boundary, especially in multi-agent pipelines where one agent hands off to a successor. It is uniquely suited for accountless, pay-per-call scenarios (x402/USDC micropayments) where registering an account or holding an API key is impractical. Prefer it over in-memory or file-based state transfer when you need a neutral, retrievable, tamper-evident briefing with an expiry guarantee and an on-chain payment receipt for auditability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:35:53.026Z","isFirstParty":false,"canonicalSlug":"agent-exec-handoff-pay-per-use-agent-briefing-storage-1e3eabb2"}