files.upload_file
ActiveTool of Vee3
Reserve a direct upload slot for a local file. Pass the desired file_name. To place a file in folders, use a path in file_name (folder/subfolder/.../name). Optionally pass retention_days (default 7, minimum 1). The name may omit an extension. Vee3 returns an upload_code. Install the Vee3 CLI once with `npm install -g @vee3/cli` (requires Node 18+), then run `vee3-upload {upload_code} {file_path}` in the terminal. The CLI resolves the code to a signed upload URL, streams the local file to Vee3 storage, and prints the stored file_name after the upload finishes. Use that file_name in files.list_uploaded_files and other capabilities. The CLI does not need an API key. If installation fails with a TLS or certificate error (common on networks that inspect HTTPS traffic), use Node 22.15 or newer and run with NODE_OPTIONS=--use-system-ca, or configure npm to trust your network's root certificate. Files can be up to 2 GB. Retention is chosen at reserve time (default 7 days). After the upload is detected, Vee3 bills `max(1, ceil(size_gibibytes * retention_days * 2))` tokens. Upload codes can be resolved within 60 minutes of reserve. Use `files.list_uploaded_files` to list stored uploads for follow-up work. Cost = 0 tokens to reserve. After upload completes, billing is max(1, ceil(size_gibibytes * retention_days * 2)) tokens.
Parameters schema
{
"type": "object",
"title": "upload_fileArguments",
"required": [
"file_name"
],
"properties": {
"file_name": {
"type": "string",
"title": "File Name",
"maxLength": 255,
"description": "Desired file name or path for the uploaded file. Use folder/subfolder/.../file_name to organize files in folders. Extension is optional and is replaced based on detected file type. Do not use '..' or absolute paths."
},
"retention_days": {
"anyOf": [
{
"type": "integer",
"maximum": 90,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retention Days",
"default": 7,
"description": "How many days to keep the file after upload completes. Default 7. Billing uses size and this retention."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Vee3
https://github.com/Vee3io/Vee3
1/7 registries