For AI agents: A markdown version of this page is available at https://docs-staging.datadoghq.com/jen.gilbert/astro-base/api/latest/dashboards.md. A documentation index is available at /llms.txt.
homeHomedocsDocsapiAPI
Language
Datadog site

Dashboards

Manage all your dashboards, as well as access to your shared dashboards, through the API. See the Dashboards page for more information.

Create a new dashboard

POSThttps://api.datadoghq.com/api/v1/dashboardhttps://api.us3.datadoghq.com/api/v1/dashboardhttps://api.us5.datadoghq.com/api/v1/dashboardhttps://api.datadoghq.eu/api/v1/dashboardhttps://api.ap1.datadoghq.com/api/v1/dashboardhttps://api.ap2.datadoghq.com/api/v1/dashboardhttps://api.uk1.datadoghq.com/api/v1/dashboardhttps://api.ddog-gov.com/api/v1/dashboardhttps://api.us2.ddog-gov.com/api/v1/dashboard

Get usage stats for all dashboardspreview

GEThttps://api.datadoghq.com/api/v2/dashboards/usagehttps://api.us3.datadoghq.com/api/v2/dashboards/usagehttps://api.us5.datadoghq.com/api/v2/dashboards/usagehttps://api.datadoghq.eu/api/v2/dashboards/usagehttps://api.ap1.datadoghq.com/api/v2/dashboards/usagehttps://api.ap2.datadoghq.com/api/v2/dashboards/usagehttps://api.uk1.datadoghq.com/api/v2/dashboards/usagehttps://api.ddog-gov.com/api/v2/dashboards/usagehttps://api.us2.ddog-gov.com/api/v2/dashboards/usage

Get a dashboard

GEThttps://api.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.uk1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}

Get usage stats for a dashboardpreview

GEThttps://api.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.us3.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.us5.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.datadoghq.eu/api/v2/dashboards/{dashboard_id}/usagehttps://api.ap1.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.ap2.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.uk1.datadoghq.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.ddog-gov.com/api/v2/dashboards/{dashboard_id}/usagehttps://api.us2.ddog-gov.com/api/v2/dashboards/{dashboard_id}/usage

Get all dashboards

GEThttps://api.datadoghq.com/api/v1/dashboardhttps://api.us3.datadoghq.com/api/v1/dashboardhttps://api.us5.datadoghq.com/api/v1/dashboardhttps://api.datadoghq.eu/api/v1/dashboardhttps://api.ap1.datadoghq.com/api/v1/dashboardhttps://api.ap2.datadoghq.com/api/v1/dashboardhttps://api.uk1.datadoghq.com/api/v1/dashboardhttps://api.ddog-gov.com/api/v1/dashboardhttps://api.us2.ddog-gov.com/api/v1/dashboard

Update a dashboard

PUThttps://api.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.uk1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}

Delete a dashboard

DELETEhttps://api.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us3.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.us5.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.datadoghq.eu/api/v1/dashboard/{dashboard_id}https://api.ap1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ap2.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.uk1.datadoghq.com/api/v1/dashboard/{dashboard_id}https://api.ddog-gov.com/api/v1/dashboard/{dashboard_id}https://api.us2.ddog-gov.com/api/v1/dashboard/{dashboard_id}

Delete dashboards

DELETEhttps://api.datadoghq.com/api/v1/dashboardhttps://api.us3.datadoghq.com/api/v1/dashboardhttps://api.us5.datadoghq.com/api/v1/dashboardhttps://api.datadoghq.eu/api/v1/dashboardhttps://api.ap1.datadoghq.com/api/v1/dashboardhttps://api.ap2.datadoghq.com/api/v1/dashboardhttps://api.uk1.datadoghq.com/api/v1/dashboardhttps://api.ddog-gov.com/api/v1/dashboardhttps://api.us2.ddog-gov.com/api/v1/dashboard

Restore deleted dashboards

PATCHhttps://api.datadoghq.com/api/v1/dashboardhttps://api.us3.datadoghq.com/api/v1/dashboardhttps://api.us5.datadoghq.com/api/v1/dashboardhttps://api.datadoghq.eu/api/v1/dashboardhttps://api.ap1.datadoghq.com/api/v1/dashboardhttps://api.ap2.datadoghq.com/api/v1/dashboardhttps://api.uk1.datadoghq.com/api/v1/dashboardhttps://api.ddog-gov.com/api/v1/dashboardhttps://api.us2.ddog-gov.com/api/v1/dashboard

Create a shared dashboard

POSThttps://api.datadoghq.com/api/v1/dashboard/publichttps://api.us3.datadoghq.com/api/v1/dashboard/publichttps://api.us5.datadoghq.com/api/v1/dashboard/publichttps://api.datadoghq.eu/api/v1/dashboard/publichttps://api.ap1.datadoghq.com/api/v1/dashboard/publichttps://api.ap2.datadoghq.com/api/v1/dashboard/publichttps://api.uk1.datadoghq.com/api/v1/dashboard/publichttps://api.ddog-gov.com/api/v1/dashboard/publichttps://api.us2.ddog-gov.com/api/v1/dashboard/public

Get a shared dashboard

GEThttps://api.datadoghq.com/api/v1/dashboard/public/{token}https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}https://api.datadoghq.eu/api/v1/dashboard/public/{token}https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}https://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ddog-gov.com/api/v1/dashboard/public/{token}https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}

Update a shared dashboard

PUThttps://api.datadoghq.com/api/v1/dashboard/public/{token}https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}https://api.datadoghq.eu/api/v1/dashboard/public/{token}https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}https://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ddog-gov.com/api/v1/dashboard/public/{token}https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}

Send shared dashboard invitation email

POSThttps://api.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitationhttps://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitationhttps://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation

Get all invitations for a shared dashboard

GEThttps://api.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitationhttps://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitationhttps://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation

Revoke a shared dashboard URL

DELETEhttps://api.datadoghq.com/api/v1/dashboard/public/{token}https://api.us3.datadoghq.com/api/v1/dashboard/public/{token}https://api.us5.datadoghq.com/api/v1/dashboard/public/{token}https://api.datadoghq.eu/api/v1/dashboard/public/{token}https://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}https://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}https://api.ddog-gov.com/api/v1/dashboard/public/{token}https://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}

Revoke shared dashboard invitations

DELETEhttps://api.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us3.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.us5.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.datadoghq.eu/api/v1/dashboard/public/{token}/invitationhttps://api.ap1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ap2.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.uk1.datadoghq.com/api/v1/dashboard/public/{token}/invitationhttps://api.ddog-gov.com/api/v1/dashboard/public/{token}/invitationhttps://api.us2.ddog-gov.com/api/v1/dashboard/public/{token}/invitation