File

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

Action	Example
Upload a file	Upload a document, image, or data file and get a shareable URL
List files	See all files you've uploaded with metadata and presigned URLs
Get file info	Retrieve metadata and a fresh download URL for any file
Delete a file	Remove a file from storage

Benefits

Benefit	Description
No project required	Upload files directly — no need to create a project first
Instant URLs	Every upload returns a URL your agent can share or reference
Any file type	Documents, 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

Command	Description
`cue file upload <path>`	Upload a file and get ID + URL
`cue file list`	List all your files
`cue file get <file_id>`	Get file metadata and download URL
`cue file delete <file_id>`	Delete a file

Troubleshooting

Error	Fix
Not authenticated	Run `cue` then `/auth` to log in
403 Forbidden	Not authorized to access this file
404 Not Found	File ID incorrect
Storage quota exceeded	Delete unused files to free space

File

On this page