PUT
/
v1
/
dashboard_panels
/
{id}
Update a dashboard panel
curl --request PUT \
  --url https://api.rootly.com/v1/dashboard_panels/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "dashboard_panels",
    "attributes": {
      "name": "<string>",
      "params": {
        "display": "line_chart",
        "description": "<string>",
        "table_fields": [
          "<string>"
        ],
        "legend": {
          "groups": "all"
        },
        "datalabels": {
          "enabled": true
        },
        "datasets": [
          {
            "name": "<string>",
            "collection": "alerts",
            "filter": [
              {
                "operation": "and",
                "rules": [
                  {
                    "operation": "and",
                    "condition": "=",
                    "key": "<string>",
                    "value": "<string>"
                  }
                ]
              }
            ],
            "group_by": "<string>",
            "aggregate": {
              "operation": "count",
              "key": "<string>",
              "cumulative": true
            }
          }
        ]
      },
      "position": {
        "x": 123,
        "y": 123,
        "w": 123,
        "h": 123
      }
    }
  }
}'
{
  "data": {
    "id": "18c6cb72-fde2-48aa-92f8-01a3116b62bb",
    "type": "dashboard_panels",
    "attributes": {
      "dashboard_id": "1eb05e4c-b7d3-4727-9909-1e34b667e6db",
      "name": "test update",
      "params": {
        "display": "line_chart",
        "datasets": [
          {
            "collection": "incidents",
            "filter": [],
            "aggregate": {
              "operation": "count",
              "key": "results",
              "cumulative": false
            }
          }
        ]
      },
      "position": null,
      "created_at": "2025-08-26T21:24:18.849-07:00",
      "updated_at": "2025-08-26T21:24:20.067-07:00",
      "data": [
        {
          "name": "Incidents",
          "color": null,
          "data": {
            "2025-08-19": 0,
            "2025-08-20": 0,
            "2025-08-21": 0,
            "2025-08-22": 0,
            "2025-08-23": 0,
            "2025-08-24": 0,
            "2025-08-25": 0,
            "2025-08-26": 0
          }
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/vnd.api+json

Response

200 - application/vnd.api+json

dashboard panel updated

The response is of type object.