{"uid":"cap_QFwHNW1PaeOYofsqLhpep","slug":"x402-gateway-production-up-railway-app-24170405","name":"IPFS Pin via x402 Gateway","description":"Pin JSON, files, or URLs to IPFS for decentralized storage","url":"https://x402-gateway-production.up.railway.app/api/ipfs/pin","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body","method"],"properties":{"body":{"type":"object","properties":{"url":{"type":"string","example":"https://example.com/file.jpg","description":"URL of file to pin (provide json OR url, not both)"},"json":{"type":"object","example":{"hello":"world"},"description":"JSON object to pin (provide json OR url, not both)"},"name":{"type":"string","example":"data:image/png;base64,...","description":"Base64-encoded file"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"json":{"name":"Test NFT","image":"https://example.com/test-image.png","description":"A test digital asset for QA purposes"}},"response":{"cid":"bafkreig5oqs7qefi4u4l45cyqqi7exhfcmc2sayqou6qtxp4yun3fkf3ri","name":"metadata.json","size":117,"ipfs_url":"ipfs://bafkreig5oqs7qefi4u4l45cyqqi7exhfcmc2sayqou6qtxp4yun3fkf3ri","gateway_url":"https://gateway.pinata.cloud/ipfs/bafkreig5oqs7qefi4u4l45cyqqi7exhfcmc2sayqou6qtxp4yun3fkf3ri"}},"exampleRequest":{"json":{"name":"Test NFT","image":"https://example.com/test-image.png","description":"A test digital asset for QA purposes"}},"tags":["x402"],"displayCostAmount":"0.010000","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.75","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.010000/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vxGS9ajG2lHd2Mutjk-49","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Pin JSON data, files, or URLs to IPFS for decentralized, content-addressed storage","exampleAgentPrompt":"Pin this JSON object to IPFS and give me the CID: {\"name\": \"My NFT\", \"description\": \"A unique digital asset\", \"image\": \"https://example.com/nft.png\"}.","exampleUseCases":null,"resultDescription":"Returns an IPFS CID (content identifier) and a gateway URL confirming the content has been pinned to IPFS for decentralized access.","failureModes":["Invalid or malformed JSON payload returns 400 error","URL provided is unreachable or returns non-200 status","File size exceeds maximum allowed limit","Payment not included or insufficient (x402 protocol failure)","IPFS node or pinning service temporarily unavailable returns 503"],"whenToPreferThis":"Use this endpoint when you need immutable, decentralized, content-addressed storage for JSON metadata, files, or web content — especially for NFT metadata, Web3 applications, or any use case requiring permanent, censorship-resistant storage accessible via IPFS CID. Prefer over centralized storage when data integrity and decentralization matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":4,"lastUsedAt":"2026-04-29T19:19:40.788Z","lastSuccessfullyRanAt":"2026-04-29T19:19:40.788Z","lastHealthCheckAt":"2026-09-14T21:03:39.444Z","isFirstParty":false}