← Back to directory

Use when an agent must hand a file to another tool, agent or person without a st...

https://1gateway.dev/v1/files/upload

Overview

Use when an agent must hand a file to another tool, agent or person without a storage account. Input: POST the file (raw body or multipart file), ?visibility=private|public, ttl_days 1-7. png/jpeg/webp ≤5 MB, pdf ≤25 MB, UTF-8 text/json/csv ≤256 KB. Base/Monad payer owns it. Workers AI screens every upload; unsafe = not stored, still charged. Output: id, url if public (else /v1/files/sign). No secrets. Example: POST a png ?visibility=public

Protocol x402 (POST)
Price $0.0065
Payment Asset USD Coin
Payment Network eip155:8453
Category uncategorized
Provider Agent File Storage
Source bazaar
Indexed 2026-11-09 18:08:03

Health

Status unknown
Latency (p50) —
Uptime (30d) —
Reliability Score —
Last Checked Never
Last Healthy Never
Consecutive Failures 0

x402 Payment Validation

Payment Requirements —
Asset Verified —
Facilitator —

Input Schema

{ "body": { "url": "https://example.com/" }, "bodyType": "json", "method": "POST", "type": "http" }

Output Schema

{ "example": { "createdAt": "2026-11-09T00:00:00.000Z", "expiresAt": "2026-11-16T00:00:00.000Z", "filename": "daily.csv", "id": "0123456789abcdef0123456789abcdef", "mime": "text/plain; charset=utf-8", "notes": [ "Private: get a time-limited download link with /v1/files/sign." ], "price": "$0.0065", "screening": { "imagesChecked": 0, "textChunksChecked": 1, "textModel": "@cf/meta/llama-guard-3-8b", "verdict": "safe" }, "sha256": "80312ab29f0582e42ef04801cacc55ec9c6c3b8111d012d2d137cfa4253ca817", "size": 62, "status": "stored", "usage": { "bytes": 62, "files": 1, "maxFileBytes": 26214400, "maxImageBytes": 5242880, "maxTextBytes": 262144, "maxUploadsPerDay": 50, "maxWalletBytes": 524288000, "uploadsLast24h": 1 }, "visibility": "private" }, "type": "json" }