# Pinata IPFS Public File Upload

> Pinata IPFS Public File Upload is a paid API for AI agents from Pinata IPFS at mpp.pinata.cloud, paid per call via MPP, $0.01+ (dynamic), status unknown (last checked 2026-10-10).

Upload a file to IPFS via Pinata and receive a content identifier (CID) for public access

## Facts

- Endpoint: POST https://mpp.pinata.cloud/v1/pin/public?utm_source=zero.xyz
- Price: $0.01+ (dynamic)
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Pinata IPFS
- Docs: https://docs.pinata.cloud/files/mpp/overview
- Website: https://pinata.cloud
- Tags: ipfs, pinata, storage, files, upload, download, cid
- Canonical page: https://www.zero.xyz/c/pinata-ipfs-public-81f71b24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bdy_nww1ORvJuOsBDFEpC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pinata-ipfs-public-81f71b24 -d '<json body>'
```

Example prompt: Upload this image file to IPFS using Pinata so I get back a CID I can share publicly — the file is my logo.png.

## When to prefer this

Use this endpoint when you need to pin a file to IPFS via Pinata's managed service and receive a permanent CID, especially in Web3 or NFT workflows where content-addressable public storage is required. Prefer this over generic S3-style storage when decentralization, immutability, and IPFS compatibility matter.

## Known failure modes

- File too large or malformed multipart body — 400 Bad Request
- Insufficient USDC balance for dynamic pricing based on file size — payment error
- Network timeout during large file upload
- Invalid or missing file content — 422 Unprocessable Entity
- IPFS node unavailable — 503 Service Unavailable

## How this service works

Upload file to IPFS — dynamic pricing based on file size ($0.10/GB/month, min $0.01)

## Output

Returns an IPFS content identifier (CID/hash) confirming the file has been pinned to IPFS and is publicly accessible. Pricing is dynamic based on file size at $0.10/GB/month with a $0.01 minimum per call.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pinata-ipfs-public-81f71b24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.pinata.cloud](https://www.zero.xyz/host/mpp.pinata.cloud/llms.txt)