Items

Draw a freehand stroke

Mirrors the MCP draw_stroke tool. Stroke width is fixed at 3 px; color is a NAME, not hex (case-insensitive): auto/black/omitted for theme-aware ink, or red, blue, green, orange, yellow, pink, purple, maroon, brown, gray, lightgray, teal, sage, sky, lavender — anything else (including a literal hex) silently clamps to auto. Accepts points as nested [[x,y],...], flat [x1,y1,x2,y2,...], or a JSON string of either — the server normalises.

post/api/boards/{boardId}/strokes

Request

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

Request body

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

Ink color NAME — same options as for text. Case-insensitive. Custom hex is rejected-with-clamp, not accepted literally.

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

Stroke drawn.

idstring
pointCountinteger
colorstring
authorstring

Changes

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