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

# Dashboard

The `dashboard` query retrieves detailed information about a specific dashboard by its unique identifier.

## Signature

```graphql theme={null}
dashboard(id: String!, scope: DashboardScope!, version: String): Dashboard!
```

## Arguments

<ParamField path="id" type="String!" required>
  The unique identifier of the dashboard to retrieve.
</ParamField>

<ParamField path="scope" type="DashboardScope!" required>
  The access level required for the dashboard. See [DashboardScope](/integrations/graphql-api/objects/dashboard-scope).
</ParamField>

<ParamField path="version" type="String">
  Optional version identifier for retrieving a specific historical snapshot of the dashboard.
</ParamField>

## Response

Returns a `Dashboard` object containing the complete dashboard configuration and metadata. See [Dashboard](/integrations/graphql-api/objects/dashboard) for the schema.

## Usage example

This example shows how to retrieve a dashboard with editor access:

```graphql theme={null}
query GetDashboard($id: String!, $scope: DashboardScope!) {
  dashboard(id: $id, scope: $scope) {
    id
    name
    description
    widgets {
      id
      title
      nlQuery
      widgetType
      layout {
        top
        left
        width
        height
      }
      visualization {
        id
        title
        type
      }
      summaryWidgetConfig{
        customInstructions
      }
    }
    filters {
      id
      parsedFilter {
        filterId
        operator
        lhs {
          displayName
        }
        rhs {
          literal {
            flattened {
              literal {
                value
              }
            }
          
          }
        }
      }
    }
    accessLevel
  }
}
```

<RequestExample>
  ```bash Request theme={null}
  curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <jwt_token>" \
    -d '{
      "query": "query GetDashboard($id: String!, $scope: DashboardScope!) { dashboard(id: $id, scope: $scope) { id name description widgets { id title layout { top left width height } } accessLevel } }",
      "variables": {
        "id": "dashboard_123456789",
        "scope": "EDITOR"
      }
    }' \
    https://{ACCOUNT}.askwisdom.ai/graphql
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "dashboard": {
        "id": "dashboard_123456789",
        "name": "Sales Performance Dashboard",
        "description": "Monthly sales metrics and KPIs",
        "widgets": [
          {
            "id": "widget_987654321",
            "title": "Total Sales",
            "layout": {
              "top": 0,
              "left": 0,
              "width": 6,
              "height": 4
            }
          },
          {
            "id": "widget_96f27a852f55",
            "title": " ",
            "nlQuery": "",
            "widgetType": "WIDGET_TYPE_SUMMARY",
            "layout": {
              "top": 1,
              "left": 0,
              "width": 12,
              "height": 3,
            },
            "visualization": null,
            "summaryWidgetConfig": {
              "customInstructions": "User guidelines:Generate Short Summary",
            },
          },
        ],
        "filters": [
          {
            "id": "dashboard_123456789-filter_1234",
            "parsedFilter": {
              "filterId": "filter_1234",
              "operator": "FUNC_ILIKE",
              "lhs": {
                "displayName": "acc.ACCOUNT_NAME",
                "__typename": "LHS"
              },
              "rhs": {
                "literal": {
                  "flattened": [
                    {
                      "literal": {
                        "value": "\"%Account%\"",
                      },
                    }
                  ],
                },
              },
            },
          }
        ],
        "accessLevel": "EDITOR"
      }
    }
  }
  ```
</ResponseExample>

## Next steps

<CardGroup cols={2}>
  <Card title="Dashboards Query" icon="list" href="/integrations/graphql-api/queries/dashboard/dashboards">
    Retrieve multiple dashboards
  </Card>

  <Card title="Update Dashboard" icon="pen-to-square" href="/integrations/graphql-api/mutations/dashboard/update-dashboard">
    Modify dashboard properties
  </Card>

  <Card title="Dashboard Object" icon="folder" href="/integrations/graphql-api/objects/dashboard">
    Complete dashboard schema
  </Card>
</CardGroup>