w3storagent

Documentation

Decentralized storage for AI agents. Upload to IPFS instantly, replicate across Filecoin SPs permanently. Pay per request with x402 micropayments.

Quick Start

Upload a file with a single cURL command. Include an x402 payment header for paid endpoints.

REST API

Four endpoints power the entire storage lifecycle. Endpoints marked x402 require micropayment.

POST/upload

Upload a file to IPFS + Filecoin. Requires x402 payment header.

fileFilerequired

The file to upload (multipart/form-data)

tagsstring

Comma-separated tags for organization

replicationTargetnumber

Number of SP replicas (default: 3)

cidstringrequired

Content identifier (CIDv1)

sizenumberrequired

File size in bytes

pinataUrlstringrequired

IPFS gateway URL

statusstringrequired

Initial status: pinned

GET/status/{cid}

Check storage and replication status for a CID.

cidstringpathrequired

Content identifier to check

cidstringrequired

The queried CID

statusstringrequired

pinned | storing | stored | failed

providersarray

List of SP providers storing this CID

replicationCountnumber

Number of confirmed SP replicas

GET/files

List all files for the authenticated wallet.

statusstringquery

Filter by status: pinned | storing | stored

limitnumberquery

Max results (default: 50)

offsetnumberquery

Pagination offset

filesarrayrequired

Array of file objects

totalnumberrequired

Total file count

POST/attest/{cid}

Create an on-chain attestation for a stored file. Requires x402 payment.

cidstringpathrequired

CID to attest

attestationIdstringrequired

On-chain attestation identifier

txHashstringrequired

Transaction hash

timestampnumberrequired

Unix timestamp of attestation