Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
    3. Dashboards
      1. Dashboards API
      2. Charts API
      3. Chart comments API
        1. List all comments GET
        2. Get a single comment GET
        3. Create a comment POST
        4. Update a comment PATCH
        5. Remove a comment DELETE
      4. Dashboard sections API
      5. Dashboard alerts API
      6. Dashboard groups API
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage API ↗
  7. Alternative to
    1. Lightstep

Get a single chart comment

Returns a single comment from a chart.

GET https://telemetry.betterstack.com/api/v2/dashboards/{dashboard_id}/charts/{chart_id}/comments/{id}

URL parameters

dashboard_id
required integer

The unique identifier of the dashboard.

chart_id
required integer

The unique identifier of the chart.

id
required integer

The unique identifier of the comment.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the comment.

Response body

{
  "data": {
    "id": "1442",
    "type": "chart_comment",
    "attributes": {
      "chart_id": 18718,
      "content": "Latency back to normal after the rollout.",
      "created_at": "2026-08-17T13:41:02.114Z",
      "updated_at": "2026-08-17T13:41:02.114Z",
      "dt": "2026-08-17T13:30:00.000Z",
      "plaintext_content": "Latency back to normal after the rollout.",
      "user_email": "sarah@example.com",
      "api_authored": false
    }
  }
}
404

A comment with the specified ID was not found on this chart.

Response attributes

id
string

The ID of the comment.

type
string

Always chart_comment.

attributes.chart_id
integer

The ID of the chart the comment is on.

attributes.content
string

The comment as stored. A comment that tags a team member holds the mention as internal markup, so send this value back unchanged to keep the mention when you update the comment.

attributes.created_at
string

When the comment was created, as an ISO 8601 date-time in UTC.

attributes.updated_at
string

When the comment was last updated, as an ISO 8601 date-time in UTC.

attributes.dt
string

The point on the chart's time axis the comment is pinned to, as an ISO 8601 date-time in UTC with millisecond precision, or null when the comment has no position.

attributes.plaintext_content
string

The comment as readable text, with any mention rendered as @Team member.

attributes.user_email
string

The e-mail of the team member who wrote the comment. Omitted when the comment has no author, such as one created with a team API token, one synced from Uptime, or one whose author was deleted.

attributes.api_authored
boolean

Whether the comment was created with a team API token, which leaves it without an author. A team API token can update and remove only these comments.

Example request

cURL
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/dashboards/1234/charts/18718/comments/1442" \
     --header "Authorization: Bearer $TOKEN"


Previous article

List all comments on a chart

Next article

Create a chart comment