Upload image
upload_imageUpload an image file to attach it to a space and receive Markdown code for embedding it in a page. Accepts PNG, JPEG, GIF, or WebP up to 5 MB; supply the image via path, base64 data, or URL.
Instructions
Attach an image to a space and get back the Markdown to embed it in a page. Use this to put screenshots and diagrams into the pages you write, so whoever reads the page later — human or agent — can see what you saw. ACCEPTS: PNG, JPEG, GIF, WebP. Max 5 MB. SVG is rejected (script-injection vector). The format is detected from the file's own bytes, not its name. HOW TO SUPPLY THE IMAGE — give exactly one of: • path — absolute path to an image file on this machine. Prefer this: the bytes never pass through the conversation. • data — base64 of the file's bytes (a "data:image/png;base64,..." URI is also accepted). • source_url — a public http(s) URL; the server fetches it. If you can only SEE an image (e.g. a screenshot another tool returned), you cannot re-encode it from what you see — you need the file. Save it to disk, then pass its "path". Counts against the workspace's image storage quota (Free 50 MB, Pro 5 GB).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Base64 of the image FILE'S BYTES (a "data:image/png;base64,..." URI is accepted too). Not a description of the image, and not something you can produce from an image you only viewed. | |
| path | No | Absolute path to an image file on this machine. Best option — the bytes never enter the conversation. | |
| space | No | Space UUID or "workspaceSlug/spaceSlug" path. Optional for space-scoped tokens. | |
| alt_text | No | Alt text for the returned Markdown snippet. | |
| filename | No | Original filename to record (cosmetic; defaults to image.<ext>). | |
| source_url | No | Public http(s) URL the server fetches the image from. Must be publicly reachable — private/loopback addresses are refused. |