{"uid":"cap_P7OA89ivVi0NOhFsl4ytP","slug":"pyfile-x402-secret-retrieval-api-fce55368","name":"Pyfile x402 Secret Retrieval API","description":"Retrieve a stored secret by id + access token. Returns the decrypted value, label and read count.","url":"https://pyfile-agent.taile3ff35.ts.net:10000/secret/get?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"queryParams":{"type":"object","properties":{}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json","description":"Output payload format."},"example":{"type":"object","required":["ok","id","value"],"properties":{"id":{"type":"string"},"ok":{"type":"boolean"},"label":{"type":"string","description":"Optional human-readable label."},"reads":{"type":"integer","description":"Number of times the secret has been read."},"value":{"type":"string","description":"The decrypted secret value."}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6PW5MOr603RHKoMZfxoyz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a stored secret by its ID and access token, returning the decrypted value, label, and read count.","exampleAgentPrompt":"Retrieve my stored secret with ID 'sec_abc123' using access token 'tok_xyz789' and tell me its decrypted value and how many times it's been read.","exampleUseCases":[{"title":"Retrieving a stored API credential","prompt":"Fetch the secret with ID 'sec_a1b2c3' using my access token 'tok_k9m7p2' — I need to see the decrypted value and how many times it's been accessed so far."},{"title":"Checking secret read count for audit","prompt":"Pull up secret 'sec_audit99' with token 'tok_readcheck' and tell me the label and how many times it's been read — I want to know if anyone has accessed it unexpectedly."},{"title":"Retrieving a one-time password or passphrase","prompt":"Get the decrypted value of secret ID 'sec_passphrase7' using access token 'tok_secure42' so I can use it right now."}],"resultDescription":"Returns a JSON object with a boolean 'ok' status, the secret's 'id', its decrypted 'value' string, an optional human-readable 'label', and an integer 'reads' count indicating how many times the secret has been retrieved.","failureModes":["Invalid or expired access token returns an error or ok:false","Secret ID not found returns a not-found error","Unauthorized access attempt rejected","Network timeout reaching Tailscale-hosted service","Malformed request body missing required fields"],"whenToPreferThis":"Use this endpoint when you need to retrieve a previously stored secret by its unique ID and a paired access token, especially when you also want to track how many times the secret has been read. Suitable for agent workflows that need to fetch credentials, passphrases, or sensitive values stored via the Pyfile secret system.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:09:09.340Z","isFirstParty":false,"canonicalSlug":"pyfile-x402-secret-retrieval-api-fce55368"}