Create a file upload link
create_file_uploadGenerate a one-time upload link to transfer a local file to Hail by curl for email attachments or verification documents, returning the upload ID and ready-to-use curl command.
Instructions
Create 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``. | |
| content_type | Yes | The file's MIME type, such as ``application/pdf``. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||