{"uid":"cap_oNg0TpMy7DRBvEHciB4Z_","slug":"pinata-private-ipfs-upload-d94b9cb4","name":"Pinata Private IPFS Upload","description":"Upload to private IPFS (fileSize in JSON body)","url":"https://402.pinata.cloud/v1/pin/private","method":"POST","headers":{},"bodySchema":null,"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_e0XLeaRa_S4agmrtVFDf1","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":"Uploads a file to private IPFS storage via Pinata, accessible only with authentication, using a crypto micropayment per upload","exampleAgentPrompt":"Upload this 250KB JSON file to private IPFS storage on Pinata — I want it pinned privately so only I can access it, not publicly retrievable.","exampleUseCases":[{"title":"Private document archival on IPFS","prompt":"Store this 500KB contract PDF privately on IPFS using Pinata so only I can retrieve it — pin it privately and give me the CID."},{"title":"Sensitive data backup for dApp","prompt":"I need to upload a 1.2MB encrypted user data file to private IPFS through Pinata — make sure it's pinned privately, not publicly accessible."},{"title":"NFT metadata private staging","prompt":"Pin this 80KB JSON metadata file privately on IPFS via Pinata before I make it public — I want to review the CID first without it being publicly discoverable."}],"resultDescription":"Returns a confirmation of the private IPFS pin including the content identifier (CID) and pin status, confirming the file has been stored privately and is only accessible with proper authentication.","failureModes":["Payment failure — insufficient USDC balance or x402 payment not processed correctly","File size mismatch — fileSize in request body does not match actual uploaded content","File too large — exceeds per-call size limits for the micropayment tier","Network timeout — IPFS pinning node unreachable or slow to respond","Invalid request body — missing or malformed fileSize field","Authentication error — private pin retrieval credentials not returned properly"],"whenToPreferThis":"Choose this endpoint when you need to store files on IPFS in a private, non-publicly-accessible manner and want to pay per upload with USDC crypto micropayments without requiring an account. Prefer this over the public IPFS upload sibling when content confidentiality matters. Prefer over traditional cloud storage when decentralized, censorship-resistant storage is required and the user is comfortable with crypto payments via x402.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T21:03:39.894Z","isFirstParty":false}