List annotations
List annotations
Deploys, incidents and config changes marked on charts.
Annotations draw a vertical line on every chart over the dataset they name.
GET
/v1/annotationsQuery parameters
datasetstringOnly annotations touching this dataset.
typestringFilter by kind, e.g. deploy.
sincedatetimeRFC 3339.
curl -X GET https://api.logstreem.com/v1/annotations \
-H "Authorization: Bearer $LOGSTREEM_TOKEN"Responses
200OK
{
"object": "list",
"data": [
{
"object": "annotation",
"id": "ann_4a81e0c3f6a5b2d1e0c9",
"type": "deploy",
"title": "checkout v2.14.0",
"datasets": ["api-gateway-prod"],
"time": "2026-09-06T09:00:00.000Z",
"url": "https://github.com/acme/checkout/releases/tag/v2.14.0"
}
],
"has_more": false,
"next_cursor": null
}401Unauthorized
{
"error": {
"type": "authentication_error",
"code": "missing_token",
"message": "No API token provided.",
"doc_url": "https://logstreem.com/docs/errors#missing_token",
"request_id": "req_9f3c2a7b41de08c5b2e6"
}
}Try itsandbox