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?

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

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)

POST /v1/aion/upload

Upload a file and get a download URL

POST /v1/aion/upload-url

Upload from a URL (Discord, Slack, webhooks)

GET /v1/upload/{id}/status

Check upload status and network replication progress

POST /v1/upload/{id}/download-url

Get a fresh download URL for a previously uploaded file

DELETE /v1/upload/{id}/delete

Delete a file from the database and Walrus storage network

GET /v1/storage

The folder tree with paths and file counts, the files in one folder, and bytes used against the plan limit

POST /v1/folders

Create a folder, optionally nested inside another (8 levels deep)

PATCH /v1/folders/{id}

Rename a folder, move it under another parent, or both

DELETE /v1/folders/{id}

Delete a folder and its subfolders — the files inside move back to the root, nothing is removed from storage

POST /v1/files/{id}/move

File an upload into a folder, or back to the storage root

POST /v1/aion/marketplace/list

List a file on the marketplace for public discovery and paid downloads

Every request needs your API key in the X-Aion-Key header:

X-Aion-Key: your_api_key_here

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