v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Dashboard Sharing

List shared dashboards for a dashboard

Retrieve shared dashboards associated with the specified dashboard.

get/api/v2/dashboard/{dashboard_id}/shared

Path parameters

dashboard_idstring required
Example:abc-def-ghi

ID of the dashboard.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2026-01-01T00:00:00.000Z",
        "embeddable_domains": [
          "https://example.com"
        ],
        "expiration": "2026-02-01T00:00:00.000Z",
        "global_time": {
          "live_span": "1h"
        },
        "invitees": [
          {
            "access_expiration": "2026-01-15T09:30:00.000Z",
            "created_at": "2026-01-01T00:00:00.000Z",
            "email": "jane.doe@example.com"
          }
        ],
        "last_accessed": "2026-01-15T09:30:00.000Z",
        "selectable_template_vars": [
          {
            "default_values": [
              "prod"
            ],
            "name": "environment",
            "prefix": "env",
            "type": "group",
            "visible_tags": [
              "prod"
            ]
          }
        ],
        "share_type": "invite",
        "status": "active",
        "title": "Q1 Metrics Dashboard",
        "token": "abc-123-token",
        "url": "https://p.datadoghq.com/sb/abc-123-token",
        "viewing_preferences": {
          "theme": "system"
        }
      },
      "id": "12345",
      "relationships": {
        "dashboard": {
          "data": {
            "id": "abc-def-ghi",
            "type": "dashboard"
          }
        },
        "sharer": {
          "data": {
            "id": "00000000-0000-0000-0000-000000000000",
            "type": "user"
          }
        }
      },
      "type": "shared_dashboard"
    }
  ],
  "included": [
    {
      "attributes": {
        "title": "Q1 Metrics Dashboard"
      },
      "id": "abc-def-ghi",
      "type": "dashboard"
    }
  ]
}