Request a presigned upload URL for a digital file
request_digital_file_upload_urlRequest a presigned URL to upload a digital file, then PUT the file bytes and confirm to link it to a product.
Instructions
Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.
Returns a presigned URL to upload a digital file to. After receiving the response, PUT the file bytes directly to the uploadUrl, then call the confirm endpoint to link the file to the product.
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": {
"product_id": "<product_id>",
"output_file": "<output_file>"
},
"name": "request_digital_file_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 | |
| product_id | Yes | Native productId | |
| 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. |