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

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# 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 →](https://docs.datadoghq.com/api/latest/dashboards/create-a-new-dashboard.md){% #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  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-usage-stats-for-all-dashboards.md) 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  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-a-dashboard.md){% #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}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-usage-stats-for-a-dashboard.md) 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  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-all-dashboards.md){% #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  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/update-a-dashboard.md){% #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}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/delete-a-dashboard.md){% #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}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/delete-dashboards.md){% #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  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/restore-deleted-dashboards.md){% #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  |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/create-a-shared-dashboard.md){% #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  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-a-shared-dashboard.md){% #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}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/update-a-shared-dashboard.md){% #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}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/send-shared-dashboard-invitation-email.md){% #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  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/get-all-invitations-for-a-shared-dashboard.md){% #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  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/revoke-a-shared-dashboard-url.md){% #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}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.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 →](https://docs.datadoghq.com/api/latest/dashboards/revoke-shared-dashboard-invitations.md){% #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  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.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 |