Get uploaded files
get_file_picker_handoffResolve an upload reference from the file picker’s Continue message to the verified files and their workspace. Use the returned upload_id values with tools that accept them in that workspace; use each file's temporary url where a generation model input expects a file URL. The reference itself is not an upload_id. Resolving files does not create or change a brand or add assets to a Brand Library.
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": {
"reference": "<reference>"
},
"name": "get_file_picker_handoff"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| reference | Yes | Reference sent after the user chooses Continue in the file picker. Resolve it here to obtain the verified upload IDs and their workspace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | Verified uploaded files. | |
| workspace_id | Yes | Workspace the files were staged in, or null for a personal workspace that has no ID. |