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": "a641a50e-857a-4c08-9d01-5b682aa524fb",
    "type": "dashboard_panels",
    "attributes": {
      "dashboard_id": "2dac46de-1718-41ac-a86c-2ca463f24029",
      "name": "test",
      "params": {
        "display": "line_chart",
        "datasets": [
          {
            "collection": "incidents",
            "filter": [],
            "aggregate": {
              "operation": "count",
              "key": "results",
              "cumulative": false
            }
          }
        ]
      },
      "position": null,
      "created_at": "2025-08-15T07:11:10.677-07:00",
      "updated_at": "2025-08-15T07:11:10.677-07:00",
      "data": [
        {
          "name": "Incidents",
          "color": null,
          "data": {
            "2025-08-08": 0,
            "2025-08-09": 0,
            "2025-08-10": 0,
            "2025-08-11": 0,
            "2025-08-12": 0,
            "2025-08-13": 0,
            "2025-08-14": 0,
            "2025-08-15": 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.