Aion API overview
The Aion API lets you upload and share files programmatically. It's designed for AI agents, automation workflows, and integrations.
Who is this for?
- AI agents & bots — ChatGPT, Claude, custom bots that need to upload files
- Automation workflows — Zapier, Make, n8n, or custom scripts
- Developers — Any app that needs file sharing via API
How it works
One simple request is all you need:
Send your file + API key
One POST request with your file
→
Get download URL
Share it with anyone
What you need
- API key — Get one from your dashboard
- A file — Up to 500 MB on Basic, 1 GB on Pro, most types accepted (executables and shell scripts are rejected)
Endpoints
POST /v1/aion/uploadUpload a file and get a download URL
POST /v1/aion/upload-urlUpload from a URL (Discord, Slack, webhooks)
GET /v1/upload/{id}/statusCheck upload status and network replication progress
POST /v1/upload/{id}/download-urlGet a fresh download URL for a previously uploaded file
DELETE /v1/upload/{id}/deleteDelete a file from the database and Walrus storage network
POST /v1/aion/marketplace/listList a file on the marketplace for public discovery and paid downloads
Authentication
Every request needs your API key in the X-Aion-Key header:
X-Aion-Key: your_api_key_hereNext steps
- Quickstart — Upload your first file in 2 minutes
- MCP Server quickstart — Connect Payaion to Cursor, Claude Desktop, or any MCP client
- Upload flow — Detailed guide with idempotency, status polling, and pricing
- Marketplace & Pricing — List files for sale with per-download pricing
- Errors & retries — Handle failures gracefully
- Example repo — Runnable Node.js and Python quickstarts, end to end
- OpenAPI spec — Full API reference
Ready to start?
- Create API keys in seconds
- No passwords
- No gas fees to sign in