Add annotation
Add a note to a date on the main traffic chart.
POST https://cotlet.dev/api/v1/plausible/annotations
write Confirm
Does what right-click > Add note does on the chart. A site note is seen by all team members and by anyone using a shared link, and only team members with editor access or above can add one. Plausible allows 500 annotations per site. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| site string required | string | Domain of the site as the Sites page lists it, e.g. acme-shop.example. |
| date string required | string | Date of the note, YYYY-MM-DD. |
| note string required | string | Text of the note, 255 characters at most. |
| visibility string | string | personal (only you) or site (everyone with dashboard access). Default: site. |
Request
curl -X POST https://cotlet.dev/api/v1/plausible/annotations \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site":"site","date":"date","note":"note"}'result = client.call("plausible", "add_annotation", {"site":"site","date":"date","note":"note"})const result = await cotlet.call('plausible', 'add_annotation', {"site":"site","date":"date","note":"note"});cotlet call plausible add_annotation --data '{"site":"site","date":"date","note":"note"}'Example response
{
"site": "acme-shop.example",
"date": "2026-10-14",
"note": "Launch email sent to 8,000 subscribers",
"visibility": "site",
"status": "added"
}