Create a file upload link
create_file_uploadCreate a one-time link that uploads one file from a shell with curl.
The bytes go from the local disk to Hail directly, not through the tool call,
so any file that is not tiny goes this way.
An email attachment can be up to 25 MB. A verification document must be
JPG, PNG or PDF, up to 10 MB, and is usable for 1 hour after the upload.
Returns ``id``, ``upload_url``, ``expires_at`` (15 minutes), ``max_bytes``
and a ready ``curl`` line with a ``'FILE_PATH'`` placeholder for the
file's absolute path.
The link needs no key and works once. The upload response holds
``size_bytes`` and ``sha256`` to compare with the local file.Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"purpose": "<purpose>",
"filename": "<filename>",
"content_type": "<content_type>"
},
"name": "create_file_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| purpose | Yes | What the file is for. ``email_attachment``: its ``id`` goes in ``send_email``'s ``attachment_ids``. ``verification_document``: its ``id`` goes in the ``files`` of ``check_verification`` and ``submit_verification`` as ``{slot, upload_id}``. | |
| filename | Yes | File name, such as ``passport.pdf``. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| content_type | Yes | The file's MIME type, such as ``application/pdf``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||