AI-facing

Board snapshot (MCP get_board shape)

Full structured JSON snapshot of a board, identical in shape to the MCP get_board tool. Includes every text node's COMPLETE content (Mermaid source stays intact inside the content field), every stroke's point array, and image metadata. Heavy image payloads (>8 kB base64) are elided (dataUrl: null); tiny images (small SVGs, icon-sized PNGs) ride along inline so AI clients can render them without a second round-trip.

The boardId can be supplied as a trailing path segment OR as ?board=... query param — the query form accepts a raw UUID, a hash URL like https://cnvs.app/#<id>, or any URL whose path tail is the id.

Caching for pollers: every response carries a weak ETag header derived from the board's last-updated timestamp + per-kind item counts. Send it back as If-None-Match and unchanged boards short-circuit to 304 Not Modified (empty body, no rate-limit burn). HEAD is also supported for cheap existence/freshness probes.

get/json/{boardId}

Request

  • Base URL: https://cnvs.app
  • URL: https://cnvs.app/json/{boardId}
  • Auth: none declared

Headers

If-None-Matchstring

Weak ETag from a previous response. Unchanged boards respond 304 Not Modified.

Response

Board snapshot.

boardIdstring required
mode'draw' | 'todo'

Board mode. draw (default) = infinite-canvas whiteboard; todo = kanban task board. Switchable whenever the board is empty of real content (drawings + tasks); empty/seeded columns don't count, so a cleared board can switch again.

Changes

No recorded changes to this operation across all 1 revision of this API.