Skip to main content
Files are the core resource in AgentDrive. Any file your agent produces — PDFs, code, images, datasets, spreadsheets — can be stored and retrieved.

​
File properties

​
Content upload

Files are uploaded as base64-encoded content in the request body. MIME type is auto-detected from the file extension, or you can set it explicitly via content_type.

​
Content hash

A SHA-256 hash is computed on every upload. Use this to verify file integrity or detect duplicates.

​
Content preview

For text-based files (text/*, application/json, text/csv), AgentDrive stores the first ~500 characters as content_preview. This lets agents and humans quickly see what a file contains without downloading it.

​
Tags

Tags are string labels you attach to files for organization and filtering. Pass tags as a query parameter to filter file listings.

​
TTL / expiring files

Set expires_at to an ISO 8601 timestamp and the file will be automatically deleted after that time. Useful for temporary agent outputs that don’t need long-term storage.