How to Upload a Large File

Use the upload API to send files up to 500 MB directly into this project's persistent storage. Once uploaded, you'll get back a URL you can paste anywhere in the builder.

Easiest Option

Use the Upload Page

Click the + button in the chat panel (same one you use to attach images) and select your file from your computer. Once attached, tell me what to do with it — for example "use this file for the flipbook" — and I'll place it automatically. No URL needed.

https://jjrwg322a3.preview.c38.airoapp.ai/upload-file

OR use the API directly

Your Admin Key

Every upload request must include your Admin Key as a request header. You set this in your project secrets as ADMIN_SECRET_KEY.

x-admin-key: YOUR_ADMIN_SECRET_KEY

Upload Endpoint

Send a POST request with your file as multipart/form-data to this URL. Files up to 500 MB are accepted.

https://jjrwg322a3.preview.c38.airoapp.ai/api/upload

Form Field Name

The file must be attached under the field name "file" in your multipart form.

field name: file

curl Example

curl -X POST \
  "https://jjrwg322a3.preview.c38.airoapp.ai/api/upload" \
  -H "x-admin-key: YOUR_ADMIN_SECRET_KEY" \
  -F "file=@/path/to/your/file.pdf"

Successful Response

{
  "ok": true,
  "filename": "your-file-1234567890.pdf",
  "originalName": "your-file.pdf",
  "size": 4823042,
  "url": "/airo-assets/uploads/your-file-1234567890.pdf"
}

After uploading, copy the url from the response and paste it into the builder chat. For example: "Swap the flipbook PDF to this URL: /airo-assets/uploads/your-file.pdf"