{"uid":"cap_60sDkjvWGm2pyX4zMnSi6","slug":"x402-storage-ipfs-permanent-storage-0b055b89","name":"x402 Storage – IPFS Permanent Storage","description":"Store data permanently on IPFS (2 B)","url":"https://api.x402.storage/store","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":null,"accepted":[]},"paymentMethods":[],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Permanently stores arbitrary data on IPFS via x402-authenticated micropayment, returning a content address for later retrieval","exampleAgentPrompt":"Store this JSON blob permanently on IPFS and give me back the CID so I can reference it later — it's about 2 bytes of metadata for a smart contract.","exampleUseCases":[{"title":"Immutable smart contract metadata","prompt":"I need to permanently pin my NFT metadata JSON to IPFS right now and get back the content hash so I can embed it in the token URI on-chain."},{"title":"Decentralized document archival","prompt":"Archive this signed legal agreement permanently on IPFS — I want a content address that will always point to the exact file, no matter what happens to our servers."},{"title":"Agent state checkpoint storage","prompt":"Save this agent decision log to IPFS for me so it's permanently stored and I can prove later what state the agent was in at this exact moment — give me the CID when done."}],"resultDescription":"Returns an IPFS content identifier (CID) and confirmation that the data has been pinned permanently on the IPFS network. The CID can be used to retrieve the content at any time via any IPFS gateway.","failureModes":["Payment failure: insufficient USDC balance or invalid x402 payment token returns a payment error","Oversized payload: content exceeding platform limits returns a payload-too-large error","Network error: IPFS pinning service unavailability causes a timeout or 503","Invalid content: malformed request body may return a 400 bad request","Rate limiting: excessive requests may result in throttling"],"whenToPreferThis":"Choose this endpoint when you need permanent, immutable, content-addressed storage on IPFS with micropayment-per-call pricing — ideal for blockchain/Web3 workflows where you need a CID for on-chain references, or when you want decentralized storage without managing your own IPFS node. Prefer over centralized object storage (S3, GCS) when immutability and decentralization matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:39.878Z","isFirstParty":false}