Create freehand annotation
In this article, you will learn how to create freehand annotation.
Create freehand annotation
Request Type: POST
Header: Authorization: ApiKey <my_api_token>
URL: https://app.banyanboard.com/api/annotation_groups/<my_annotation_group_uuid>/annotations/
Payload:
{
"fill_color": "transparent",
"path": "M 0 120 L 0 120 L 30 90 L 70 60 L 90 55 L 95 80 L 92 110 L 85 130 L 75 125 L 70 120 L 70 110 L 75 95 L 85 80 L 100 65 L 120 50 L 140 40 L 160 35 L 180 30 L 200 30 L 220 35 L 230 45 L 240 60 L 245 75 L 245 85 L 245 95 L 250 80 L 280 70 L 310 65 L 330 70 L 340 60 L 380 40 L 400 35 L 420 30 L 450 25 L 480 20",
"stroke_color": "#00c853",
"stroke_width": 5,
"top_left_x": "40.25",
"top_left_y": "70.10",
"text": "",
"text_fontsize": 0,
"type": "freehand",
"z_index": 1
}
Results:
{
"date_created": "2026-03-26T12:40:18.789012Z",
"fill_color": "transparent",
"height": "140.000",
"path": "M 0 120 L 0 120 L 30 90 L 70 60 L 90 55 L 95 80 L 92 110 L 85 130 L 75 125 L 70 120 L 70 110 L 75 95 L 85 80 L 100 65 L 120 50 L 140 40 L 160 35 L 180 30 L 200 30 L 220 35 L 230 45 L 240 60 L 245 75 L 245 85 L 245 95 L 250 80 L 280 70 L 310 65 L 330 70 L 340 60 L 380 40 L 400 35 L 420 30 L 450 25 L 480 20",
"stroke_color": "#00c853",
"stroke_width": 5,
"top_left_x": "40.250",
"top_left_y": "70.100",
"text": "",
"text_fontsize": 0,
"type": "freehand",
"was_edited": true,
"uuid": "c4d2e1f8-7a9b-4c6d-8e1f-5a2b3c4d6e7f",
"width": "480.000"
}