Request Image Upload
request_image_uploadUpload an image attached to the conversation — logos, photos, banners, anything the user has shown you. Returns a one-time URL the caller's runtime PUTs the raw bytes to (handles any size up to 50MB). Workflow: (1) call this tool, (2) PUT raw image bytes to the returned upload_url with Content-Type header (raw binary, NOT base64), (3) call finalize_image_upload with the returned asset_id. The URL expires in 5 minutes — issue this immediately before your PUT, not at the start of a long reasoning chain. JPEG/PNG/WebP only; no SVG. If the user is asking about photos they've already uploaded to their Zarla photo library, use list_site_photos first instead.
Annotations: read-only=false, destructive=false, idempotent=false, open-world=false. Why: Creates a one-time upload slot in Zarla's own storage; nothing existing changes (additive, not destructive). Not idempotent: each call creates another slot. Closed-world: the slot lives in Zarla's own storage — no third-party or user-controlled system is contacted.
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": {
"site_id": "<site_id>",
"mime": "<mime>"
},
"name": "request_image_upload"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| alt | No | Accessibility alt text. Stored when finalize_image_upload returns. | |
| mime | Yes | Image MIME type. JPEG/PNG/WebP only — SVG is not supported. | |
| site_id | Yes | The site this image belongs to | |
| byte_size | No | Optional byte size for upfront cap check (max 50MB). |