{"uid":"cap_DKBsmYY_4TkIXC01593pO","slug":"pyfile-secret-list-e30f6b02","name":"Pyfile Secret List","description":"List secret metadata (id, label, reads, created_at) for an access token — no values returned.","url":"https://pyfile-agent.taile3ff35.ts.net:10000/secret/list?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","secrets"],"properties":{"ok":{"type":"boolean"},"secrets":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"reads":{"type":"integer"},"created_at":{"type":"string"}}},"description":"Metadata for every secret under the token (no values)."}}}}}}},"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_DDir45orK5yYf0ulkiWwR","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":"Lists metadata (id, label, read count, created_at) for all secrets associated with an access token, without revealing secret values.","exampleAgentPrompt":"Can you list all the secrets stored under my current token — just the metadata like IDs, labels, and how many times each has been read?","exampleUseCases":[{"title":"Audit stored secrets before rotation","prompt":"Show me all the secrets I have saved under my token, including their labels and when they were created, so I can decide which ones need to be rotated."},{"title":"Check secret access frequency","prompt":"I want to see how many times each of my stored secrets has been read — list all of them with their read counts."},{"title":"Verify a secret was registered","prompt":"Can you pull up the list of secrets under my token and confirm there's one labeled 'openai-key' in there?"}],"resultDescription":"Returns a JSON object with an 'ok' boolean and a 'secrets' array. Each element in the array contains: id (string), label (string), reads (integer count of how many times the secret has been accessed), and created_at (ISO timestamp). No secret values are ever included in the response.","failureModes":["Invalid or missing access token returns an authentication error","Token with no associated secrets returns an empty secrets array","Network timeout or service unavailability returns a connection error","Malformed request body returns a validation error"],"whenToPreferThis":"Use this endpoint when you need to enumerate and audit secrets metadata for a given access token — especially to check which secrets exist, their labels, read counts, or creation timestamps — without needing the actual secret values. Prefer this over a direct secret-fetch when the goal is auditing, listing, or verifying existence rather than consuming a secret.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:35:55.253Z","isFirstParty":false,"canonicalSlug":"pyfile-secret-list-e30f6b02"}