Find a guide, feature, or API endpoint. Try “FTP”, “alerts”, or “instruments”.

Browse documentation

Docs/API reference / Dashboard widgets

Read dashboard widgets

Requires `developer_api.dashboards.read` on the project-scoped Developer API connection. Use the API origin supplied for your deployment. Unknown query parameters and unexpected request bodies are rejected.

GET/dev-api/v1/p/{project_id}/dashboards/{dashboard_id}/widgets/{widget_id}All endpoints ↗

The request panel saves credentials and API settings in this browser. Privacy details

GET
/dev-api/v1/p/{project_id}/dashboards/{dashboard_id}/widgets/{widget_id}

Authorization

developerApiKey
AuthorizationBearer <token>

Project-scoped Developer API connection key. Grant only the required operation permissions.

In: header

Path Parameters

project_id*string
Match.*\S.*
Length1 <= length <= 128
dashboard_id*string
Match.*\S.*
Length1 <= length <= 128
widget_id*string
Match^[A-Za-z0-9_-]{21}$
Length21 <= length <= 21

Query Parameters

include_archived?boolean

Include archived resources explicitly. Archived history still requires authorization.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

bash
curl -X GET "https://example.com/dev-api/v1/p/string/dashboards/string/widgets/stringstringstringstr"
json
{
  "request_id": "string",
  "data": {
    "id": "stringstringstringstr",
    "name": "string",
    "grid_x": 1,
    "grid_y": 1,
    "grid_width": 1,
    "grid_height": 1,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "widget_type": "graph",
    "configuration": {
      "show_legend": true,
      "series": [
        {
          "id": "stringstringstringstr",
          "instrument_id": "string",
          "variable_id": "string",
          "alias": "string",
          "graph_type": "line",
          "color": "blue",
          "style": "solid",
          "weight": "thin",
          "marker": "none",
          "y_axis": "left",
          "connect_nulls": true,
          "rounding": {
            "mode": "exact",
            "decimal_places": null
          },
          "aggregation": {
            "aggregation_operation": "sum",
            "rolling": true,
            "aggregation_interval": "hour"
          }
        }
      ]
    }
  }
}