Request a pre-signed upload URL
request_media_upload_urlCreate a pre-signed upload URL for a new image; upload the image bytes directly to the returned URL.
Instructions
Rate limit: 20 requests / minute per shop. See Rate limiting.
Returns a pre-signed upload URL for uploading a new image. After receiving the response, PUT the image bytes directly to the uploadUrl.
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": {
"output_file": "<output_file>"
},
"name": "request_media_upload_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Size of the file in bytes. Must match the `x-goog-content-length-range` header sent when uploading the bytes to `uploadUrl`. | |
| account | No | Exact private shop profile label; not a provider identity or authorization proof. | |
| confirm | No | Set true only when the user asked for exactly this action. | |
| payload | No | Complete current native JSON body; cannot mix with native body flags or payload_file. | |
| fileName | No | Name of the file | |
| contentType | No | MIME type of the file | |
| output_file | Yes | Absolute NEW owner-private receipt file; exclusive0600 creation, no overwrite. Upload/public-token URLs never enter ordinary output. | |
| payload_file | No | Absolute regular non-symlink native JSON body file, at most1MiB. Cannot mix with payload or body flags. |