{"uid":"cap_2vZnbKbOSLJthKFZQreJ-","slug":"pinata-public-ipfs-upload-5da4f4ba","name":"Pinata Public IPFS Upload","description":"Upload to public IPFS (fileSize in JSON body; returns signed upload URL after payment)","url":"https://402.pinata.cloud/v1/pin/public","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_eT8FaIDK7HTSj0S4r2N8j","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":"Accepts a file size, charges $0.001 USDC via x402, and returns a signed upload URL for pinning a file to public IPFS","exampleAgentPrompt":"Upload my 2MB file to public IPFS using Pinata — pay the per-upload fee and give me back the signed upload URL so I can push the file.","exampleUseCases":[{"title":"NFT metadata pinned to IPFS","prompt":"I need to pin my NFT metadata JSON (about 1KB) to public IPFS using Pinata so I can reference it from my smart contract — handle the crypto payment and get me the upload URL."},{"title":"Decentralized image hosting for dApp","prompt":"Store this 5MB artwork image on public IPFS through Pinata for my dApp — pay the upload fee automatically and return the IPFS link I can embed in the frontend."},{"title":"Account-free file publishing for agent","prompt":"My agent needs to publish a 500KB report file to public IPFS without a Pinata account — use the pay-per-upload option and give me the signed URL to complete the upload."}],"resultDescription":"A signed upload URL that the caller can use to push the actual file bytes to public IPFS. After the upload completes, the file is accessible globally via its IPFS CID.","failureModes":["Insufficient payment or failed x402 payment authorization — upload URL not issued","fileSize value missing or malformed in request body — 400 error","File size mismatch between declared and actual upload — pin may be rejected","Network or gateway timeout — signed URL not returned","IPFS pinning service outage — file pinned but may not propagate immediately"],"whenToPreferThis":"Choose this endpoint when you need to pin a file to public IPFS without a pre-existing Pinata account, can pay per-upload in USDC via the x402 protocol, and want a simple signed-URL workflow. Prefer this over the private IPFS sibling endpoint when the content must be publicly accessible to anyone on the IPFS network. Prefer it over traditional cloud storage when immutability, content addressing (CID), and decentralized availability are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:04.895Z","isFirstParty":false}