---
title: Dashboards
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Dashboards
---

# Dashboards

Manage all your dashboards, as well as access to your shared dashboards, through the API. See the [Dashboards page](https://docs.datadoghq.com/dashboards.md) for more information.

## Create a new dashboard →{% #create-a-new-dashboard %}

| Datadog site      | API endpoint                                        |
| ----------------- | --------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/dashboard |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/dashboard      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/dashboard  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/dashboard     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/dashboard |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/dashboard |

## Get usage stats for all dashboards → preview{% #get-usage-stats-for-all-dashboards %}

| Datadog site      | API endpoint                                              |
| ----------------- | --------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/dashboards/usage |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/dashboards/usage |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/dashboards/usage      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/dashboards/usage      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/dashboards/usage  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/dashboards/usage     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/dashboards/usage |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/dashboards/usage |

## Get a dashboard →{% #get-a-dashboard %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/dashboard/{dashboard_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id} |

## Get usage stats for a dashboard → preview{% #get-usage-stats-for-a-dashboard %}

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/dashboards/{dashboard_id}/usage |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/dashboards/{dashboard_id}/usage |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/dashboards/{dashboard_id}/usage      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/dashboards/{dashboard_id}/usage      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/dashboards/{dashboard_id}/usage  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/dashboards/{dashboard_id}/usage     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/dashboards/{dashboard_id}/usage |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/dashboards/{dashboard_id}/usage |

## Get all dashboards →{% #get-all-dashboards %}

| Datadog site      | API endpoint                                       |
| ----------------- | -------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/dashboard |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/dashboard      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/dashboard  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/dashboard     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/dashboard |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/dashboard |

## Update a dashboard →{% #update-a-dashboard %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}  |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/dashboard/{dashboard_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id} |

## Delete a dashboard →{% #delete-a-dashboard %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/dashboard/{dashboard_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id} |

## Delete dashboards →{% #delete-dashboards %}

| Datadog site      | API endpoint                                          |
| ----------------- | ----------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/dashboard |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/dashboard      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/dashboard  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/dashboard     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/dashboard |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/dashboard |

## Restore deleted dashboards →{% #restore-deleted-dashboards %}

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v1/dashboard |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v1/dashboard      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v1/dashboard      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v1/dashboard  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v1/dashboard     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v1/dashboard |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v1/dashboard |

## Create a shared dashboard →{% #create-a-shared-dashboard %}

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/dashboard/public |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/dashboard/public |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard/public      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/dashboard/public      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/dashboard/public  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/dashboard/public     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/dashboard/public |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/dashboard/public |

## Get a shared dashboard →{% #get-a-shared-dashboard %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/dashboard/public/{token}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/dashboard/public/{token}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/dashboard/public/{token} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/dashboard/public/{token} |

## Update a shared dashboard →{% #update-a-shared-dashboard %}

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v1/dashboard/public/{token}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}  |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v1/dashboard/public/{token}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v1/dashboard/public/{token} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v1/dashboard/public/{token} |

## Send shared dashboard invitation email →{% #send-shared-dashboard-invitation-email %}

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitation      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v1/dashboard/public/{token}/invitation     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitation |

## Get all invitations for a shared dashboard →{% #get-all-invitations-for-a-shared-dashboard %}

| Datadog site      | API endpoint                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitation      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v1/dashboard/public/{token}/invitation     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitation |

## Revoke a shared dashboard URL →{% #revoke-a-shared-dashboard-url %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/dashboard/public/{token}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/dashboard/public/{token}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/dashboard/public/{token} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/dashboard/public/{token} |

## Revoke shared dashboard invitations →{% #revoke-shared-dashboard-invitations %}

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitation      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v1/dashboard/public/{token}/invitation     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitation |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitation |