---
title: Dashboards
description: Gérez tous vos dashboards, ainsi que l'accès à vos dashboards partagés, par le biais de l'API.
breadcrumbs: Documentation > API > Dashboards
---

> For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt).

# Dashboards

Gérez tous vos dashboards, ainsi que l'accès à vos dashboards partagés, par le biais de l'API. Consultez la page relative aux [dashboards]]([https://docs.datadoghq.com/dashboards/](https://docs.datadoghq.com/dashboards.md)) pour en savoir plus.

## [Créer un dashboard](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/create-a-new-dashboard.md)

| Datadog site      | API endpoint                                        |
| ----------------- | --------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard      |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v1/dashboard |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [Get usage stats for all dashboards](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-usage-stats-for-all-dashboards.md) (preview)

| Datadog site      | API endpoint                                              |
| ----------------- | --------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/dashboards/usage      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Get usage stats for a dashboard](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-usage-stats-for-a-dashboard.md) (preview)

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/dashboards/{dashboard_id}/usage      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Récupérer un dashboard](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-a-dashboard.md)

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| 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} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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}  |

## [Récupérer tous les dashboards](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-all-dashboards.md)

| Datadog site      | API endpoint                                       |
| ----------------- | -------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v1/dashboard |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Mettre à jour un dashboard](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/update-a-dashboard.md)

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| 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} |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/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}  |

## [Supprimer un dashboard](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/delete-a-dashboard.md)

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}      |
| 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} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/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}  |

## [Delete dashboards](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/delete-dashboards.md)

| Datadog site      | API endpoint                                          |
| ----------------- | ----------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard      |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v1/dashboard |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/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  |

## [Restore deleted dashboards](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/restore-deleted-dashboards.md)

| Datadog site      | API endpoint                                         |
| ----------------- | ---------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v1/dashboard      |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v1/dashboard |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v1/dashboard |
| uk1.datadoghq.com | PATCH https://api.uk1.datadoghq.com/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  |

## [Créer un dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/create-a-shared-dashboard.md)

| Datadog site      | API endpoint                                               |
| ----------------- | ---------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard/public      |
| 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 |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [Récupérer un dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-a-shared-dashboard.md)

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| 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} |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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}  |

## [Mettre à jour un dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/update-a-shared-dashboard.md)

| Datadog site      | API endpoint                                                      |
| ----------------- | ----------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| 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} |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/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}  |

## [Envoyer un e-mail d'invitation pour un dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/send-shared-dashboard-invitation-email.md)

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| 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 |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/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  |

## [Récupérer toutes les invitations pour un dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/get-all-invitations-for-a-shared-dashboard.md)

| Datadog site      | API endpoint                                                                 |
| ----------------- | ---------------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| 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 |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/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  |

## [Révoquer une URL de dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/revoke-a-shared-dashboard-url.md)

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| 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} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/public/{token}      |
| 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} |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/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}  |

## [Révoquer des invitations de dashboard partagé](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/dashboards/revoke-shared-dashboard-invitations.md)

| Datadog site      | API endpoint                                                                    |
| ----------------- | ------------------------------------------------------------------------------- |
| 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 |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitation      |
| 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 |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/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  |