upload_page_snapshot
Upload a full-page screenshot to create an annotated page with numbered pin markers at true positions, enabling viewers to click and open thread bubbles for visual feedback on a live app.
Instructions
Upload a full-page screenshot that turns the public share report into an annotated page: viewers see the real page with numbered pin markers at true positions and click-to-open thread bubbles. Capture the page yourself (kill animations, scroll to force lazy loads, full-page shot, JPEG/WebP ≤5MB), resolve each open pin's element.selector to document-pixel coordinates IN THAT CAPTURE, and pass them as pinPositions. Owner/editor only. One snapshot per (project, page) — re-upload replaces it. pageUrl must match the pins' page_url verbatim.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | Yes | Pixel width of the uploaded image (1–4000). Pin coordinates must be in this same space. | |
| height | Yes | Pixel height of the uploaded image (1–60000). | |
| pageUrl | Yes | Exact page_url the pins carry — copy verbatim from get_annotations. The snapshot is keyed by this string. | |
| imageB64 | No | Base64 image data, if imagePath is not available. | |
| imagePath | No | Absolute path to the JPEG/WebP file on disk (preferred — read server-side, keeps base64 out of the transcript). | |
| projectId | Yes | The project ID | |
| contentType | No | Default image/jpeg. PNG is rejected for page snapshots (size). | |
| pinPositions | No | Document-pixel coordinates of each pin in THIS image, resolved from element.selector at capture time. Pins omitted here render in the notes list only. |