{"uid":"cap_39Ck0FClNil4TDg3nKC7I","slug":"td-agent-utility-lock-acquire-1c2d85f0","name":"TD Agent Utility · Lock Acquire","description":"Independent website and deployment verification for AI agents: HTTP, DNS, TLS and Chromium screenshot evidence. Three deterministic tools, x402 V2 Base USDC.","url":"https://tdagentutility.co.uk/v1/lock-acquire?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"tool":"lock_acquire","acquired":false,"warnings":[],"checked_at":"2026-10-15T00:00:00Z","expires_at":null,"lock_token":null,"result_status":"PASS"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_vyRBDPqRbGchLP0kLmPzx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Acquires a distributed lock token as a coordination primitive before initiating website/deployment verification checks","exampleAgentPrompt":"Before we run the HTTP, DNS, and TLS checks on example.com, try to acquire a verification lock so we don't clash with any other agent running checks at the same time.","exampleUseCases":[{"title":"Exclusive deployment verification gate","prompt":"I'm about to kick off a full deployment verification for staging.myapp.com — HTTP, DNS, TLS, and a screenshot. First, grab a lock so no other agent starts the same checks while I'm running them."},{"title":"Multi-agent coordination for site audit","prompt":"We have three agents that might all try to verify the same production site at once. Can you acquire a lock for the verification job on prod.example.com before any of them starts the audit?"},{"title":"CI pipeline verification lock","prompt":"Right before the post-deploy verification step in the pipeline for api.myservice.co.uk, acquire a lock so we don't get duplicate verification runs if two deploys land close together."}],"resultDescription":"Returns a JSON object indicating whether the lock was successfully acquired (acquired: true/false), the lock token if acquired, the expiry timestamp, a result_status (e.g. PASS), the checked_at timestamp, and any warnings encountered during the attempt.","failureModes":["Lock already held by another agent — acquired returns false and lock_token is null","Service unavailable or timeout — HTTP 5xx response","Invalid or malformed request body — HTTP 4xx with error detail","Payment failure via x402 — payment not accepted, request rejected","Lock expired between check and acquire — race condition returning acquired: false"],"whenToPreferThis":"Choose this endpoint when you need to coordinate multiple agents or prevent concurrent runs of website verification checks on the same target. It acts as a distributed mutex before invoking the HTTP, DNS, TLS, or Chromium screenshot verification tools on the same service. Prefer it in CI/CD pipelines, multi-agent fleets, or any workflow where duplicate verification runs would waste resources or produce conflicting results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:40:01.462Z","isFirstParty":false,"canonicalSlug":"td-agent-utility-lock-acquire-1c2d85f0"}