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
      4. Dashboard sections API
        1. List all sections GET
        2. Get a single section GET
        3. Create a section POST
        4. Update a section PATCH
        5. Remove a section DELETE
      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

List all dashboard sections

Retrieves a list of all sections on a specific dashboard. This endpoint is not paginated; it returns all sections for a given dashboard in a single response.

GET https://telemetry.betterstack.com/api/v2/dashboards/{dashboard_id}/sections

URL parameters

dashboard_id
required integer

The unique identifier of the dashboard.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns every section on the dashboard.

Response body

{
  "data": [
    {
      "id": "890",
      "type": "section",
      "attributes": {
        "name": "Key Metrics",
        "y": 0,
        "collapsed": false,
        "explanation": null
      }
    }
  ]
}
404

A dashboard with the specified ID was not found.

Response attributes

id
string

The ID of the section.

type
string

Always section.

attributes.name
string or null

The section's title, or null when it has none.

attributes.y
integer

The section's vertical position on the dashboard grid, counted from 0 at the top.

attributes.collapsed
boolean

Whether the section is collapsed.

attributes.explanation
string or null

An explanation of the section, or null when not set.

Example request

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


Previous article

Remove a chart comment

Next article

Get a single dashboard section