{"uid":"cap_USH0EQ3r7ItrJri8eDB51","slug":"2s-blob-storage-list-fc612cf5","name":"2s Blob Storage List","description":"The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.","url":"https://2s.io/api/store/blob-list","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ns":{"type":"string","description":"Namespace to list."},"after":{"type":"string","description":"Cursor — pass the previous response's nextCursor to page forward."},"limit":{"type":"integer","maximum":1000,"minimum":1,"description":"Max keys to return. Default 50, max 1000."},"prefix":{"type":"string","description":"Only return keys starting with this prefix."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vPOL4nVLUe-Er-mD8n9IJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"List blob keys stored in a namespace, with optional prefix filtering and cursor-based pagination","exampleAgentPrompt":"List up to 100 blobs in my 'agent-cache' namespace that start with the prefix 'session/', and give me the next cursor if there are more.","exampleUseCases":[{"title":"Audit agent-cached data keys","prompt":"Show me all the keys stored in my 'reports' namespace — I want to see what my agent has cached, including their sizes and when they expire."},{"title":"Paginate through large blob namespace","prompt":"I have a lot of blobs in my 'pipeline-outputs' namespace. Get me the first 200 keys, then I'll page through the rest using the cursor you return."},{"title":"Find blobs by key prefix","prompt":"List all blobs in my 'user-data' namespace that start with the prefix 'user:42/' so I can see everything stored for that user."}],"resultDescription":"Returns a JSON object with an array of blob metadata items (key, size in bytes, content type, expiration timestamp), a pagination cursor for fetching the next page, and an optional total count. Source provenance (provider, URL, license) is also included.","failureModes":["Invalid or unknown namespace returns empty items array","Malformed cursor causes pagination error or unexpected results","Limit out of range (below 1 or above 1000) triggers validation error","Namespace not found may return ok:true with empty items rather than an error","Payment failure (x402) blocks request before reaching storage layer"],"whenToPreferThis":"Use this endpoint when you need to enumerate, browse, or audit keys stored in a 2s.io blob namespace — especially when filtering by prefix or paginating through large collections. Prefer this over a direct blob fetch when you don't know which keys exist yet or need to discover what's been stored.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:57.039Z","isFirstParty":false}