Create dashboards

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.

only available on Pro and Enterprise plans.

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 Dashboards page, click Dashboard to create a dashboard with no charts.
Duplicate an existing dashboard: Click 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 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.

Go to the Dashboards page in your source project and open the dashboard you want to copy.
Click Dashboard config in the page header and choose Export dashboard config to download a JSON file, or Copy dashboard config to copy the configuration to your clipboard.
Go to the Dashboards page in your destination project and open the dashboard you want to import into.
Click Dashboard config and choose 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.

Replace current dashboard permanently overwrites that dashboard’s charts, filters, and settings. This action cannot be undone.

Use the 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
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>.
In the response, find the view you want to copy and copy its view_data and options payloads.

Use the 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.

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>
  }'

To copy a single chart instead of a full dashboard, see Move and copy charts.

Next steps

Build charts to fill your new dashboard.
Filter and group data across every chart at once.
Set up alerts to be notified when a metric crosses a threshold.

Start

Instrument

Observe

Annotate

Evaluate

Deploy

Admin

Best practices

Create a dashboard

Rename or delete a dashboard

Copy a dashboard to another project

Next steps

​Create a dashboard

​Rename or delete a dashboard

​Copy a dashboard to another project

​Next steps

Create a dashboard

Rename or delete a dashboard

Copy a dashboard to another project

Next steps