Open an upload slot
upload_requestGet a FILE FROM THE USER -- a file on their computer or phone, or one they attached to this chat. You cannot send a file's bytes yourself: an attachment lives in a sandbox that has no connection to this service, and a file must never be retyped or base64'd into a tool call. Instead the user sends it from their own browser:
call upload_request -- you get an
upload_pagelink and anupload_idgive the user the
upload_pagelink, exactly as returned, and ask them to open it, choose the file there, and tell you when it is donewhen they say so, call
upload_confirm(upload_id=...)-- it cleans the file and returns the table The link is for one file and is private to this conversation; it takes CSV, Excel, JSON, XML, Parquet or a zip of one, of any size. If the data is at a URL, usefetchinstead -- no upload needed.
With a shell (a coding agent), the same slot takes the file directly, no page: curl -X PUT --data-binary @/path/to/file '<put_url>' The shell alternative needs a shell that reaches data-cleaner.com directly: one on the user's machine does; the assistant's own sandbox (where chat attachments live, under /mnt/user-data/) does NOT -- its proxy answers 403 host_not_allowed. From a chat, use the upload page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "upload_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | No | original filename, for format inference at confirm |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||