{"uid":"cap_5yfCrG46VFprXpyIvy6qN","slug":"agent-exec-distributed-lock-claim-post-claim-80425126","name":"agent-exec Distributed Lock Claim (POST /claim)","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/claim?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["key","plan","holder"],"properties":{"key":{"type":"string","description":"1..256 UTF-8 bytes, no '/' character -- the name you want to hold, scoped to your own paying wallet."},"plan":{"enum":["hour","day","week"],"type":"string","description":"Which plan to buy -- see x-payment-info.pricing for each plan's hold duration and price."},"holder":{"type":"string","description":"1..256 UTF-8 bytes -- an id identifying which of your own processes is claiming it."}}},"responseSchema":{"type":"object","required":["outcome","plan","claim"],"properties":{"mine":{"type":"boolean","description":"Only present when `outcome` is \"held\": true when the existing holder is YOU -- a crash-resume or duplicated retry, the exact signal this product is sold to give."},"plan":{"enum":["hour","day","week","free"],"type":"string","description":"One of the paid plans (hour/day/week) from POST /claim, or \"free\" from POST /claim/free."},"claim":{"type":"object","required":["key","holder","acquiredAt","expiresAt"],"properties":{"key":{"type":"string"},"holder":{"type":"string"},"expiresAt":{"type":"integer","description":"Unix ms the hold is free again."},"acquiredAt":{"type":"integer","description":"Unix ms the hold was granted, from the server clock at the commit that granted it."}},"description":"The current hold on this key -- yours if `outcome` is \"acquired\", or the existing holder's if `outcome` is \"held\". Never carries a wallet: the caller already knows its own."},"outcome":{"enum":["acquired","held"],"type":"string","description":"\"acquired\": you won the key (201). \"held\": somebody already holds it (200) -- NOT an error, see `mine`."},"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."}},"description":"Present on both outcomes of the PAID `POST /claim` -- the attempt is billed whether or not you won the key, so a \"held\" response still carries the receipt for the charge you incurred. Absent only from `POST /claim/free`, which never settles a payment."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0052","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.0052/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0052","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0052","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UVZdHjQfMFEoijBXpcijs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0052","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Acquires a named, time-bounded distributed lock (hold) on a key for a specified plan duration, billed per attempt via HTTP 402 micropayment.","exampleAgentPrompt":"Claim an exclusive hour-long hold on the key 'job-42' for my worker process named 'worker-A' so no other agent can run that job at the same time — pay per use, no account needed.","exampleUseCases":[{"title":"Single-agent job deduplication","prompt":"Claim the key 'invoice-processor' with a day-long hold for my process 'node-1' so no other instance picks up the same invoices — I want to know if I already held it after my last crash."},{"title":"Coordinated multi-agent pipeline step","prompt":"I need to lock the key 'etl-step-3' for a week under holder 'pipeline-runner-7' so only one agent advances that pipeline stage at a time — charge my wallet for the attempt."},{"title":"Crash-resume detection for a background worker","prompt":"Try to claim a one-hour hold on 'report-gen-weekly' for holder 'cron-agent-2' and tell me whether I'm already the one holding it, so I know whether to resume or wait."}],"resultDescription":"Returns a JSON object with: 'outcome' ('acquired' if the lock was won, 'held' if already taken), a 'claim' object with the key, holder, acquiredAt, and expiresAt timestamps, an optional 'mine' boolean (true when you already held it — useful for crash-resume), the 'plan' used, and a 'payment' receipt containing the payer wallet, amount charged, asset, network, and transaction hash. The call is billed whether or not the lock was won.","failureModes":["Payment insufficient or missing — HTTP 402 with payment requirements","Key name contains a '/' character — rejected as invalid","Plan enum value not one of hour/day/week — validation error","Holder or key exceeds 256 UTF-8 bytes — rejected","Network/blockchain settlement failure — payment may not be confirmed","Race condition: another agent acquires the key between payment and commit — outcome is 'held', payment still charged"],"whenToPreferThis":"Use this endpoint when you need accountless, pay-per-use distributed locking with no registration overhead. Prefer it over traditional lock services when operating as an autonomous agent with a crypto wallet (x402/USDC), when you need crash-resume detection via the 'mine' flag, or when you cannot pre-provision API keys. Not suitable for sub-millisecond locking latency or high-frequency contention scenarios where per-attempt billing would be costly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:31:29.366Z","isFirstParty":false,"canonicalSlug":"agent-exec-distributed-lock-claim-post-claim-80425126"}