File Upload API — IteraTools

About this tool

Send a base64-encoded file and receive a publicly accessible URL in return. Files are hosted on iteratools.com and automatically deleted after the specified TTL (default 24 hours, max 7 days). Supports any file type: images, PDFs, text files, JSONs, CSVs, and more. Ideal for AI agents that generate files and need to share them via URL.

🧪 Try it live

API Key

Pick a file

TTL (hours, 1-168)

Quick Start

curl -X POST https://api.iteratools.com/storage/upload \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "SGVsbG8gV29ybGQh",
    "filename": "hello.txt",
    "content_type": "text/plain",
    "ttl_hours": 24
  }'

Response

{
  "success": true,
  "url": "https://iteratools.com/uploads/uuid/hello.txt",
  "file_id": "a1b2c3d4-...",
  "filename": "hello.txt",
  "content_type": "text/plain",
  "size_bytes": 11,
  "expires_at": "2026-03-25T17:00:00.000Z"
}

Request Parameters

Parameter	Type	Description
file	string (base64)	Required. Base64-encoded file content (or data URL)
filename	string	Required. Name of the file (e.g. image.png)
content_type	string	Required. MIME type (e.g. image/png, application/pdf)
ttl_hours	integer	Optional. Hours until expiry (1-168, default 24)

Details

Endpoint	POST /storage/upload
Price	$0.002 / upload
Max file size	10MB
TTL range	1 hour to 168 hours (7 days)
Auth	Bearer token or x402 micropayment
Base URL	https://api.iteratools.com