> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# dashboard

> A single dashboard with its widgets. Null if it doesn't exist. Requires `dashboard:read`.



**query** `dashboard(dashboardId: ID!): Dashboard`

## Arguments

**`dashboardId`**: `ID!` (required)

## Returns

`Dashboard`

**`id`**: `ID!`

---

**`name`**: `String!`

---

**`globalRange`**: `DashboardRange!`

---

**`globalFilters`**: `String!`

JSON-encoded `ThreadMetricFilters` input, as saved. Applied in addition to each chart's filters.

---

**`widgets`**: `[DashboardWidget!]!`

Ordered by position.

---

**`createdAt`**: `DateTime!`

---

**`createdBy`**: `InternalActor!`

---

**`updatedAt`**: `DateTime!`

---

**`updatedBy`**: `InternalActor!`

## Examples

```graphql Query
query Dashboard($dashboardId: ID!) {
  dashboard(dashboardId: $dashboardId) {
    id
    name
    globalRange {
      __typename
      ... on DashboardPresetRange {
        duration
      }
    }
    globalFilters
    widgets {
      id
      kind
      chartType
      config {
        __typename
        ... on DashboardChartWidgetConfig {
          __typename
        }
      }
      layout {
        x
        width
      }
      position
    }
    createdAt {
      unixTimestamp
      iso8601
    }
  }
}
```

```json Variables
{
  "dashboardId": "id"
}
```

```json Response
{
  "data": {
    "dashboard": {
      "id": "id",
      "name": "string",
      "globalRange": {
        "__typename": "DashboardPresetRange",
        "duration": 1
      },
      "globalFilters": "string",
      "widgets": [
        {
          "id": "id",
          "kind": "TIMESERIES",
          "chartType": "BAR",
          "config": {
            "__typename": "DashboardChartWidgetConfig"
          },
          "layout": {
            "x": 1,
            "width": 1
          },
          "position": 1
        }
      ],
      "createdAt": {
        "unixTimestamp": "string",
        "iso8601": "string"
      }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.