---
title: "looker-run-dashboard"
type: docs
weight: 1
description: >
  "looker-run-dashboard" runs the queries associated with a dashboard.
aliases:
- /resources/tools/looker-run-dashboard
---

## About

The `looker-run-dashboard` tool runs the queries associated with a
dashboard.

It's compatible with the following sources:

- [looker](../../sources/looker.md)

`looker-run-dashboard` takes one parameter, the `dashboard_id`.

## Example

```yaml
kind: tools
name: run_dashboard
type: looker-run-dashboard
source: looker-source
description: |
  This tool executes the queries associated with each tile in a specified dashboard
  and returns the aggregated data in a JSON structure.

  Parameters:
  - dashboard_id (required): The unique identifier of the dashboard to run,
    typically obtained from the `get_dashboards` tool.

  Output:
  The data from all dashboard tiles is returned as a JSON object.
```

## Reference

| **field**   | **type** | **required** | **description**                                    |
|-------------|:--------:|:------------:|----------------------------------------------------|
| type        |  string  |     true     | Must be "looker-run-dashboard"                     |
| source      |  string  |     true     | Name of the source the SQL should execute on.      |
| description |  string  |     true     | Description of the tool that is passed to the LLM. |
