Start a Playground reference upload
playground_media_upload_beginCreate a short-lived signed URL for one image, video, or audio reference. Upload bytes to signedUrl with the declared Content-Type, then call playground_media_upload_complete. The URL is scoped to your user, project, and OAuth client. For a file attached in chat, prefer playground_asset_import with file. If your environment cannot reach signedUrl, stop and ask the user to choose Add image on the Berrys canvas (playground_canvas_open) instead of retrying. Returns an upload ID, signed upload URL, MIME type, byte limit and expiry.
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": {
"projectId": "<projectId>",
"filename": "<filename>",
"mimeType": "<mimeType>"
},
"name": "playground_media_upload_begin"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | Original filename of the media being uploaded, including its extension. | |
| mimeType | Yes | Media content type of the bytes to upload, such as image/png. | |
| projectId | Yes | ID of the Playground project chosen for this task; obtain it from project creation, an explicit project link or current context. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxBytes | Yes | ||
| mimeType | Yes | ||
| uploadId | Yes | ||
| expiresAt | Yes | Serialized ISO timestamp. | |
| signedUrl | Yes |