Upload file to Arweave
Arweave
Upload File to Arweave
Fetch a file from a URL and upload it to Arweave permanent storage.
POST
Upload file to Arweave
This endpoint requires authentication. Use a bearer token in the
Authorization header or an API key in the x-api-key header.Overview
Fetches the file at the givenurl and uploads it to Arweave via the Turbo SDK. The upload tier is determined automatically:
- Free — files under 5 MB, once per month per artist.
- Paid — files 5 MB or larger, or additional uploads beyond the free monthly quota. The USDC cost is debited from the artist’s smart wallet.
402 response includes the required and available amounts plus the smart_wallet address.
Example Request
Example Response
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
URL of the file to fetch and upload to Arweave.
Example:
"https://example.com/image.jpg"
Response
File uploaded
Arweave URI of the uploaded file.
Example:
"ar://TV4yYVYJ7mwsDZ19h_YNQBtRbLVIr_WITsrBnHxxW30"