Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    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. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
    3. Dashboards
      1. Dashboards API
      2. Charts API
        1. List all charts GET
        2. Get a single chart GET
        3. Create a chart POST
        4. Update a chart PATCH
        5. Remove a chart DELETE
      3. Dashboard sections API
      4. Dashboard alerts API
      5. Dashboard groups API
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

Update a chart

Updates an existing chart by its ID. You only need to provide the fields you want to change.

When updating queries, the entire array will be replaced with the one you provide. Partial updates to queries are not supported.

PATCH https://telemetry.betterstack.com/api/v2/dashboards/{dashboard_id}/charts/{id}

URL parameters

dashboard_id
required integer

The unique identifier of the dashboard.

id
required integer

The unique identifier of the chart to update.

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

name
string

A new name for the chart.

chart_type
string

A new type for the chart. The new type must be compatible with the chart's existing queries.

queries
array

A new array of query objects to replace the existing ones.

x
integer

A new horizontal position.

y
integer

A new vertical position.

w
integer

A new width in grid units.

h
integer

A new height in grid units.

200

The chart was updated successfully.

Response body

{
  "data": {
    "id": "567",
    "type": "chart",
    "attributes": {
      "name": "Updated Chart Name",
      "x": 6,
      "y": 0
    }
  }
}
404

The specified dashboard or chart was not found.

Example Request

cURL
curl --request PATCH \
  --url https://telemetry.betterstack.com/api/v2/dashboards/1234/charts/567 \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Updated Chart Name",
    "x": 6,
    "y": 0,
    "queries": [
      {
        "query_type": "sql_expression",
        "sql_query": "SELECT {{time}}, sum(value) FROM metrics GROUP BY time"
      }
    ]
  }'


Previous article

Create a chart

Next article

Remove a chart