Your agent can upload and manage files directly. Files are standalone — no need to create a project first. Upload a file, get back an ID and URL.
Upload anything. Get a link. Use it anywhere.

​
What Your Agent Does with Files

ActionExample
Upload a fileUpload a document, image, or data file and get a shareable URL
List filesSee all files you’ve uploaded with metadata and presigned URLs
Get file infoRetrieve metadata and a fresh download URL for any file
Delete a fileRemove a file from storage

​
Benefits

BenefitDescription
No project requiredUpload files directly — no need to create a project first
Instant URLsEvery upload returns a URL your agent can share or reference
Any file typeDocuments, images, audio, video, code, archives — all supported

​
For Developers

Build agents that manage files using the Cue CLI.

​
Requirements

  • cue CLI installed and authenticated (cue then /auth)

​
Upload a File

cue file upload ./report.pdf
cue file upload ./screenshot.png
cue file upload ./data.csv
Returns the file ID, URL, filename, size, and MIME type. Supported types: images (jpg, png, gif, webp), documents (pdf, json, txt, md, csv), code (html, css, js, ts, xml, yaml), archives (zip, tar, gz), media (mp3, mp4, wav). Other types upload as binary.

​
List Your Files

cue file list
Returns all your files with metadata and presigned download URLs (valid 1 hour).

​
Get File Info

cue file get <file_id>
Returns filename, size, content type, creation date, and a presigned URL.

​
Delete a File

cue file delete <file_id>

​
Command Reference

CommandDescription
cue file upload <path>Upload a file and get ID + URL
cue file listList all your files
cue file get <file_id>Get file metadata and download URL
cue file delete <file_id>Delete a file

​
Troubleshooting

ErrorFix
Not authenticatedRun cue then /auth to log in
403 ForbiddenNot authorized to access this file
404 Not FoundFile ID incorrect
Storage quota exceededDelete unused files to free space