{"uid":"cap_NwVqdQWaFaubu9mppP3T2","slug":"2s-blob-storage-put-write-endpoint-d46d51b6","name":"2s Blob Storage — Put (Write) Endpoint","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-put","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ns":{"type":"string","description":"Namespace to group blobs, 1-64 chars of [A-Za-z0-9._:-]. e.g. \"uploads\"."},"key":{"type":"string","description":"Key within the namespace, up to 256 chars. e.g. \"snapshot-42.json\"."},"data":{"type":"string","minLength":1,"description":"The file bytes, base64-encoded. Decoded size up to 3 MB."},"contentType":{"type":"string","maxLength":128,"description":"MIME type to return on read. e.g. \"application/json\", \"image/png\". Default application/octet-stream."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eWc0g4Wa-oLDnIytE2Ohl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stores a base64-encoded file blob under a namespace/key pair, returning metadata including expiry and content type.","exampleAgentPrompt":"Save this JSON snapshot to the blob store under namespace 'reports' with key 'snapshot-42.json' — here's the base64-encoded content, and set the content type to application/json.","exampleUseCases":[{"title":"Persist agent workflow state","prompt":"Save the current workflow state as a blob under namespace 'agent-state' and key 'run-007.json' — here's the base64-encoded JSON, mark it as application/json."},{"title":"Upload generated image for sharing","prompt":"Store this base64-encoded PNG image under namespace 'uploads' with the key 'chart-2024-q1.png' and content type image/png so I can retrieve it later."},{"title":"Cache API response for downstream step","prompt":"Write this base64-encoded API response payload to the blob store under namespace 'cache' and key 'weather-nyc-today.json', content type application/json."}],"resultDescription":"Returns a JSON object with ok:true and an items array containing the stored blob's key, size in bytes, expiry timestamp, and content type, plus source provenance metadata (provider, URL, license).","failureModes":["Payload exceeds 3 MB decoded size — request rejected","Invalid namespace characters outside [A-Za-z0-9._:-] — validation error","Key exceeds 256 characters — rejected","data field missing or empty (minLength:1) — rejected","Malformed base64 encoding — storage failure or corrupt write","USDC payment failure via x402 — 402 response, blob not stored"],"whenToPreferThis":"Choose this endpoint when you need a zero-signup, pay-per-call blob storage write with no infrastructure setup — ideal for AI agent workflows that need to temporarily persist files, snapshots, or generated content (up to 3 MB) between steps, billed per call in USDC with no subscription. Prefer over S3 or GCS when you want no credential management and micropayment-native storage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:18:54.516Z","isFirstParty":false}