Items

Create or update a text node

Mirrors the MCP add_text tool. Creates a NEW text node with a fresh UUID, OR updates an existing node if you pass its id (preferred over creating duplicates). Content supports cnvs markup (Markdown-ish, including [] / [ ] / [x] task-list checkboxes that render as clickable circles and toggle in source on click) and Mermaid diagrams — when using Mermaid, the ENTIRE content must be a single ```mermaid fenced block (one diagram per node). Set postit: true for a yellow sticky-note style.

post/api/boards/{boardId}/texts

Request

  • Base URL: https://cnvs.app
  • URL: https://cnvs.app/api/boards/{boardId}/texts
  • Auth: none declared

Request body

idstring

Optional stable id. Pass an existing id to UPDATE that node in place; omit to CREATE a new one with a fresh UUID.

xnumber required

World x (+x right).

ynumber required

World y (+y DOWN, standard SVG).

contentstring required

Raw content (up to 100 000 chars). Supports cnvs markup (Markdown-ish) and Mermaid (one diagram per node — entire content must be a single ```mermaid fenced block).

color'auto' | 'black' | 'red' | 'blue' | 'green' | 'orange' | 'yellow' | 'pink' | 'purple' | 'maroon' | 'brown' | 'gray' | 'lightgray' | 'teal' | 'sage' | 'sky' | 'lavender'

Ink color NAME — same mental model as clicking the ink picker. Case-insensitive. auto / black / omitted → theme-aware. red / blue / green and the extended palette (orange, yellow, pink, purple, maroon, brown, gray, lightgray, teal, sage, sky, lavender) → emphasis colors. Custom hex codes silently clamp to auto so AI writes never end up invisible on dark mode.

widthnumber nullable

Explicit width in px (160–4096), or null for auto-fit.

postitboolean

Renders as a yellow sticky note when true.

authorstring

Author tag, charset [A-Za-z0-9:_\-.], max 80 chars. Defaults to ai:rest for REST mutations. Use ai:<your-label> (e.g. ai:claude, ai:mybot) so humans can tell AI edits apart.

Response

Text created or updated.

idstring required
xnumber required
ynumber required
contentstring required
postitboolean
authorstring

Changes

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