POST
/
v1
/
dashboards
/
{dashboard_id}
/
panels
Creates a dashboard panel
curl --request POST \
  --url https://api.rootly.com/v1/dashboards/{dashboard_id}/panels \
  --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": "243ff583-f590-4065-849f-6237a929f9f6",
    "type": "dashboard_panels",
    "attributes": {
      "dashboard_id": "77f7afe3-e105-4142-9f44-b46ff03a5b04",
      "name": "test",
      "params": {
        "display": "line_chart",
        "datasets": [
          {
            "collection": "incidents",
            "filter": [],
            "aggregate": {
              "operation": "count",
              "key": "results",
              "cumulative": false
            }
          }
        ]
      },
      "position": null,
      "created_at": "2025-07-17T12:07:16.473-07:00",
      "updated_at": "2025-07-17T12:07:16.473-07:00",
      "data": [
        {
          "name": "Incidents",
          "color": null,
          "data": {
            "2025-07-10": 0,
            "2025-07-11": 0,
            "2025-07-12": 0,
            "2025-07-13": 0,
            "2025-07-14": 0,
            "2025-07-15": 0,
            "2025-07-16": 0,
            "2025-07-17": 0
          }
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

dashboard_id
string
required

Body

application/vnd.api+json

Response

201
application/vnd.api+json

dashboard panel created

The response is of type object.