Skip to content
GoBananaBeta

get_canvas

Read a board - brief, directions with their spec, sections, items with source links and notes, palettes, the parts library and Frankenstein pages - or list your 10 most recent boards.

Plan Quota Changes data Hints
All None No read only

Inputs

Section titled “Inputs”
Name Type Required Limits What it does
canvasId string No 1 to 100 characters The board to read. Leave out to list your recent boards
thumbs boolean No default true Small thumbnails of up to 12 placed references after the text (see get_snapshot)

List mode

Section titled “List mode”
{ "name": "get_canvas", "arguments": {} }
Recent canvases, newest first:
- c3f1a0d2-…: "Coffee launch page" (24 references, 3 directions, updated 2026-10-12) brief: launch page for a specialty coffee roaster
- 7be0…: "Frosted checkout" (31 references, 4 directions, updated 2026-10-09) brief: flight checkout screen for a GCC travel OTA
If the user's request continues one of these, pass its canvasId to bend_brief, search_references and add_to_canvas to add to it.

A new account gets “No canvases yet. Create one with new_canvas.”

Read mode

Section titled “Read mode”
{ "name": "get_canvas", "arguments": { "canvasId": "c3f1a0d2-6b1e-4d8a-9f4b-0a1b2c3d4e5f" } }

The text lists, in order:

  1. Title, web link and brief.
  2. Directions: id, title, search text, platform, pages, kept, dropped or not rated, and a compact spec (type, signature, pattern, layout, color, style words). The long build prompt is left out here; exports use it.
  3. Sections with their items: image it_…: Title (dribbble.com) https://… [art direction] [ship] note: steal: …, notes and swatches.
  4. Items not in a section.
  5. Palettes.
  6. Parts library by role, each part with its source, (guessed crop) when the server guessed, and its note.
  7. Frankenstein pages: title, id, platform, view mode, remix origin, and a skeleton row by row (role, slot id, part id, source link, note).
  8. How many search results wait in the tray.
  9. Thumbnails: each placed reference’s small image after the line that names it (up to 12; thumbs: false to skip), then a line asking the agent to look before it rates or notes.
  10. Mobbin images to refresh: Mobbin image links expire about 30 days after the connector returns them. Screens placed more than 25 days ago are listed with how to refresh them: look the screen up again in Mobbin and call add_to_canvas with the same screenId, which replaces the image in place. Until then the board shows “Image expired, open on Mobbin”.

The skills read a board once at the start and trust write results after that, instead of calling get_canvas after every change.

Messages

Section titled “Messages”
Message Fix
“That canvas was not found…” Wrong id or another account
“Pass a canvasId, or nothing to list recent canvases.” Bad input shape