File Management
Manage the complete file lifecycle from a single tool. This includes uploading new files, listing existing files for the current budget, retrieving metadata and signed URLs, downloading content, deleting files, creating password-protected share links, auditing access history, updating metadata and tags, and extending expiration.
Actions
upload_standard
Generate a signed upload URL for a file up to 10MB.
Required fields:
content_length_bytes: exact file size in bytes, 1 to 10,485,760
Optional fields:
filenamecontent_typeexpiration_days(1-7)sharedpassword_max_uses(1-10)password_max_minutes(1-10)metadatatags
upload_large
Generate a signed upload URL for a file over 10MB and up to 100MB.
Required fields:
content_length_bytes: exact file size in bytes, greater than 10,485,760 and up to 104,857,600
Optional fields:
filenamecontent_typeexpiration_days(1-7)sharedpassword_max_uses(1-10)password_max_minutes(1-10)metadatatags
list
List active files for the current budget. Results are newest first and include preview URLs when available.
Optional fields:
tagsdate_fromdate_tolimitoffseturl_expiration_minutes
get
Get metadata and a fresh signed download URL for a file.
Required fields:
file_id
Optional fields:
url_expiration_minutes
download
Download base64 content for files up to 5MB, or get a signed URL for larger files.
Required fields:
file_id
Optional fields:
return_contenturl_expiration_minutes
delete
Delete a file permanently.
Required fields:
file_id
share
Create or refresh a password-protected public share link.
Required fields:
file_id
Optional fields:
password_max_usespassword_max_minutes
access_history
View share access history for a file.
Required fields:
file_id
Optional fields:
limit
update_metadata
Update metadata and tags on a file.
Required fields:
file_id
Optional fields:
metadatatagsadd_tagsremove_tags
extend_expiration
Extend expiration by 7 days.
Required fields:
file_id
Notes
- Upload actions return a signed
upload_url; you must then PUT the file bytes to that URL using the returned headers. listis budget-scoped and includes preview URLs when the file type supports preview.- Signed URLs can be requested for up to 7 days.
downloadwithreturn_content: trueis limited to files 5MB or smaller.- Share passwords are always auto-generated.
extend_expirationadds 7 days each time it is called.







