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

# Create dashboards

> Create a dashboard by cloning the built-in one, starting empty, or duplicating an existing dashboard, then rename, delete, or copy it between projects.

export const feature_0 = "Creating dashboards"

export const verb_0 = "is"

The built-in **Cost and quality** dashboard covers all data in your project, but it is read-only. To change what a dashboard shows, create one of your own.

Creating, editing, and renaming dashboards requires the project-level **Projects > Update** [permission](/docs/admin/access-control).

<Note>
  {feature_0} {verb_0} only available on [Pro and Enterprise plans](/docs/plans-and-limits#plans).
</Note>

## Create a dashboard

You have three starting points:

* **Clone the built-in dashboard**: Open **Cost and quality** and click **Clone dashboard** to copy its charts into an editable dashboard. Use this when the preset charts are close to what you want.
* **Start empty**: On the [**<Icon icon="chart-no-axes-column" /> Dashboards**](https://www.braintrust.dev/app/~/dashboards) page, click <Icon icon="plus" /> **Dashboard** to create a dashboard with no charts.
* **Duplicate an existing dashboard**: Click <Icon icon="ellipsis" /> **Dashboard actions** > **Duplicate dashboard**.

On a dashboard you created, changes save automatically. This applies to adding, editing, and removing charts, and to filter and grouping changes.

## Rename or delete a dashboard

Click <Icon icon="ellipsis" /> **Dashboard actions**, then choose **Rename dashboard** or **Delete**.

To remove several at once, select them on the dashboards list and choose **Delete selected dashboards**. The built-in dashboard cannot be selected or deleted.

## Copy a dashboard to another project

If you have built a useful dashboard in one project, copy it to another rather than recreating it.

<Tabs>
  <Tab title="UI" icon="mouse-pointer-2">
    1. Go to the [**<Icon icon="chart-no-axes-column" /> Dashboards**](https://www.braintrust.dev/app/~/dashboards) page in your source project and open the dashboard you want to copy.
    2. Click <Icon icon="download" /> **Dashboard config** in the page header and choose **<Icon icon="download" /> Export dashboard config** to download a JSON file, or **<Icon icon="copy" /> Copy dashboard config** to copy the configuration to your clipboard.
    3. Go to the [**<Icon icon="chart-no-axes-column" /> Dashboards**](https://www.braintrust.dev/app/~/dashboards) page in your destination project and open the dashboard you want to import into.
    4. Click <Icon icon="download" /> **Dashboard config** and choose **<Icon icon="upload" /> Import dashboard config** to upload the JSON file, or paste the copied configuration anywhere on the page using your keyboard.
       * On a dashboard you created, choose **Replace current dashboard**.
       * On the built-in **Cost and quality** dashboard, which is read-only, choose **Create new dashboard** and give it a name.

    <Warning>
      **Replace current dashboard** permanently overwrites that dashboard's charts, filters, and settings. This action cannot be undone.
    </Warning>
  </Tab>

  <Tab title="API" icon="code">
    1. Use the [list views](/docs/api-reference/views/list-views) API endpoint to fetch the "monitor" views in your source project. Pass the following query parameters:

       * `object_type=project`
       * `object_id=<source-project-id>`
       * `view_type=monitor`

       ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
       curl --request GET \
         --url 'https://api.braintrust.dev/v1/view?object_type=project&object_id=<source-project-id>&view_type=monitor' \
         --header 'Authorization: Bearer <your-api-key>'
       ```

       Older org-owned views are stored at the organization level. To include them, list with `object_type=org_project` and `object_id=<your-org-id>`.
    2. In the response, find the view you want to copy and copy its `view_data` and `options` payloads.
    3. Use the [create view](/docs/api-reference/views/create-view) API endpoint to create the view in the destination project. Set `object_id` to the destination project ID. In the `options` payload, be sure to set `projectId` to the destination project ID as well.

       ```bash theme={"theme":{"light":"github-light","dark":"github-dark-dimmed"}}
       curl --request POST \
         --url https://api.braintrust.dev/v1/view \
         --header 'Authorization: Bearer <your-api-key>' \
         --header 'Content-Type: application/json' \
         --data '
         {
           "object_type": "project",
           "object_id": "<destination-project-id>",
           "view_type": "monitor",
           "name": "<new-view-name>",
           "view_data": <view-data-payload>,
           "options": <options-payload>
         }'
       ```
  </Tab>
</Tabs>

<Tip>
  To copy a single chart instead of a full dashboard, see [Move and copy charts](/docs/observe/dashboards/build-charts#move-and-copy-charts).
</Tip>

## Next steps

* [Build charts](/docs/observe/dashboards/build-charts) to fill your new dashboard.
* [Filter and group data](/docs/observe/dashboards#filter-and-group-data) across every chart at once.
* [Set up alerts](/docs/observe/alerts) to be notified when a metric crosses a threshold.