Prepare file uploads
create_file_picker_uploadsReserve temporary upload URLs for files selected in the upload picker. Use the picker’s workspace and each file’s exact byte length. Upload the raw bytes before verifying completion. Returns one upload_id and its PUT instructions per 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": {
"workspace_id": "<workspace_id>",
"files": "<files>"
},
"name": "create_file_picker_uploads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | Local files to stage, described by their filenames, exact byte lengths, and MIME types when known. Their combined size must not exceed 256 MiB. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Omit it or pass "unknown" if you are not certain; the tool runs the same either way. Recorded only for the server developer's analytics. | |
| workspace_id | Yes | Destination selected when opening the file picker. Pass that workspace's ID, or null when the picker targets the personal workspace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uploads | Yes | One upload reservation for each requested file. | |
| message_for_assistant | No | Context, explanations, or actionable guidance for the calling assistant. Hosts may display it, but it is not copy that must be shown to the user verbatim. |