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

# Dashboard Secure Embed

Manage securely embedded Datadog dashboards. Secure embeds use HMAC-SHA256 signed sessions for authentication, enabling customers to embed dashboards in their own applications with server-side auth control. Unlike public dashboards (open URL) or invite dashboards (email-based access), secure embeds provide programmatic access control.

**Requirements:**

- **Embed** sharing must be enabled under **Organization Settings** > **Public Sharing** > **Shared Dashboards**.
- You need [an API key and an application key](https://docs.datadoghq.com/account_management/api-app-keys.md) to interact with these endpoints.

## Create a secure embed for a dashboard → preview{% #create-a-secure-embed-for-a-dashboard %}

| Datadog site      | API endpoint                                                                           |
| ----------------- | -------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/dashboard/{dashboard_id}/shared/secure-embed      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed  |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed |

## Get a secure embed for a dashboard → preview{% #get-a-secure-embed-for-a-dashboard %}

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

## Update a secure embed for a dashboard → preview{% #update-a-secure-embed-for-a-dashboard %}

| Datadog site      | API endpoint                                                                                    |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token}  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared/secure-embed/{token} |

## Delete a secure embed for a dashboard → preview{% #delete-a-secure-embed-for-a-dashboard %}

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