{"uid":"cap_IE2QQEH9zS6YapcfCH3H-","slug":"agent-rest-stop-locker-read-fe66ddbb","name":"Agent Rest Stop – Locker Read","description":"Reads a locker object, or the backup copy.","url":"https://agent-gas-station.agent-gas-station.workers.dev/v1/LockerRead?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A-tJYZCVj8syCbTtJc-YA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reads a locker object (or its backup copy) by key from Agent Rest Stop's key-value store.","exampleAgentPrompt":"Can you read the locker object stored under the key 'session-abc123' — and grab the backup copy if the primary isn't available?","exampleUseCases":[{"title":"Resuming agent state mid-workflow","prompt":"Fetch the locker object saved under key 'workflow-run-7f2a' so we can pick up where the last agent left off."},{"title":"Retrieving a forwarded pointer target","prompt":"I stored a forward pointer earlier — can you read the locker entry for key 'fwd-ptr-checkout-42' and return what's inside?"},{"title":"Checking backup copy after primary failure","prompt":"The primary locker read for key 'snapshot-nightly-v3' might be stale — please retrieve it and fall back to the backup copy if needed."}],"resultDescription":"Returns the locker object stored at the given key, or its backup copy if the primary is unavailable. The response contains the persisted payload previously written to that locker slot.","failureModes":["Key not found — locker entry does not exist for the given key","Both primary and backup copies unavailable or expired","Missing or empty key field in request body","Payment not processed (x402 payment required, $0.01 USDC)","Worker timeout or Cloudflare infrastructure error"],"whenToPreferThis":"Use this endpoint when you need to retrieve a previously stored locker object by an exact key within the Agent Rest Stop ecosystem, especially when resilience via backup copy is needed. Prefer this over sibling endpoints when you know the specific key and need the raw object, not just metadata (like age or pointer info).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:41.183Z","isFirstParty":false,"canonicalSlug":"agent-rest-stop-locker-read-fe66ddbb"}