{"uid":"cap_78cp4eiPCMNb-_3vh810t","slug":"payweave-storage-list-files-7e25e2a1","name":"PayWeave Storage List Files","description":"Pay-once file storage with permanent URLs.","url":"https://storage.payweave.services/list","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"anyOf":[{"not":{}},{"type":"object","properties":{"cursor":{"type":"string"},"ttl_days":{"enum":[1,7,30,90,365],"type":"number"}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","required":["items","count","truncated","cursor"],"properties":{"count":{"type":"integer","minimum":0},"items":{"type":"array","items":{"type":"object","required":["url","key","bytes","content_type","ttl_days","uploaded_at","expires_at"],"properties":{"key":{"type":"string"},"url":{"type":"string","format":"uri"},"bytes":{"type":"integer","minimum":0},"ttl_days":{"type":"integer"},"expires_at":{"type":"string"},"uploaded_at":{"type":"string"},"content_type":{"type":"string"}},"additionalProperties":false}},"cursor":{"type":["string","null"]},"truncated":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.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_3ug3XmFidgQ3bipMgqj-5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Lists all files stored in PayWeave Storage, returning metadata including URLs, sizes, content types, and expiry info, with cursor-based pagination.","exampleAgentPrompt":"Show me all the files I currently have in my PayWeave Storage — I want to see their URLs, sizes, and when they expire. Start from the beginning and filter for files with a 30-day TTL.","exampleUseCases":[{"title":"Audit storage usage and cleanup","prompt":"Walk through all my stored files and show me which ones are expiring soon. I need to identify any large files that are taking up space and figure out what to delete before they expire automatically."},{"title":"Generate list of active file URLs","prompt":"Pull together a complete list of all my current PayWeave files with their permanent URLs and file sizes. I need to send these URLs to my team so they can access everything we have stored right now."},{"title":"Monitor content type distribution","prompt":"Show me all the files in my storage organized by their content type — I want to see how much space I'm using for images versus documents versus videos, and check the metadata on anything stored there."}],"resultDescription":"Returns a paginated list of stored file objects, each containing a permanent URL, storage key, byte size, content type, TTL in days, upload timestamp, and expiry timestamp, plus a count, truncation flag, and cursor for fetching the next page.","failureModes":["Invalid or expired cursor returns an error or empty result","Unknown ttl_days enum value (must be one of 1, 7, 30, 90, 365) causes validation failure","Payment not received (x402 payment required) returns 402 status","No files stored returns empty items array with count 0","Network timeout returns no response"],"whenToPreferThis":"Use this endpoint when you need to enumerate or audit all files stored in PayWeave Storage, retrieve their permanent URLs, check expiration dates, or paginate through large file sets. Prefer this over direct file access when you don't know the exact file key or URL in advance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:33:13.974Z","isFirstParty":false}