Create freehand annotation
In this article, you will learn how to create freehand annotation.
Create freehand annotation
Request Type: POST
Authorization 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"
}
Related Articles
Freehand
In this article, you will learn how to create a freehand drawing. Before you begin Drawings can be added to both images and videos and must be linked with captions. To learn how to create captions in SPAN sports performance analysis platform, refer ...
Create annotation group
In this article, you will learn how to create an annotation group. Create annotation group Request Type: POST Authorization Header: Authorization: ApiKey <my_api_token> URL: https://app.banyanboard.com/api/assets/<my_file_uuid>/annotation_groups/ ...
Create rectangle annotation
In this article, you will learn how to create rectangle annotation. Create rectangle annotation Request Type: POST Authorization Header: Authorization: ApiKey <my_api_token> URL: ...
Create circle annotation
In this article, you will learn how to create circle annotation. Create circle annotation Request Type: POST Authorization Header: Authorization: ApiKey <my_api_token> URL: ...
Create text annotation
In this article, you will learn how to create text annotation. Create text annotation Request Type: POST Authorization Header: Authorization: ApiKey <my_api_token> URL: ...