---
title: "Update a shared dashboard"
method: PUT
path: "/api/v1/dashboard/public/{token}"
tags: ["Dashboards"]
---

# Update a shared dashboard

`PUT /api/v1/dashboard/public/{token}`

Update a shared dashboard associated with the specified token.

## Path parameters

- `token` string, required

## Request body

- SharedDashboardUpdateRequest — Update a shared dashboard's settings.
  - `embeddable_domains` string[] — The `SharedDashboard` `embeddable_domains`.
  - `expiration` string, date-time, nullable — The time when an OPEN shared dashboard becomes publicly unavailable.
  - `global_time` SharedDashboardUpdateRequestGlobalTime, nullable — Timeframe setting for the shared dashboard.
    - `live_span` '15m' | '1h' | '4h' | '1d' | '2d' | '1w' | '1mo' | '3mo' — Dashboard global time live_span selection
  - `global_time_selectable_enabled` boolean, nullable — Whether to allow viewers to select a different global time setting for the shared dashboard.
  - `invitees` SharedDashboardInviteesItems[] — The `SharedDashboard` `invitees`.
    - `access_expiration` string, date-time, nullable — Time of the invitee expiration. Null means the invite will not expire.
    - `created_at` string, date-time — Time that the invitee was created.
    - `email` string, required — Email of the invitee.
  - `selectable_template_vars` SelectableTemplateVariableItems[], nullable — List of objects representing template variables on the shared dashboard which can have selectable values.
    - `default_value` string — The default value of the template variable.
    - `name` string — Name of the template variable.
    - `prefix` string — The tag/attribute key associated with the template variable.
    - `type` string, nullable — The type of variable. This is to differentiate between filter variables (interpolated in query) and group by variables (interpolated into group by).
    - `visible_tags` string[], nullable — List of visible tag values on the shared dashboard.
  - `share_list` string[], nullable — List of email addresses that can be given access to the shared dashboard.
  - `share_type` 'open' | 'invite' | 'embed', nullable — Type of sharing access (either open to anyone who has the public URL or invite-only).
  - `status` 'active' | 'paused' — Active means the dashboard is publicly available. Paused means the dashboard is not publicly available.
  - `title` string — Title of the shared dashboard.
  - `viewing_preferences` ViewingPreferences — The viewing preferences for a shared dashboard.
    - `high_density` boolean — Whether the widgets on the shared dashboard should be displayed with high density.
    - `theme` 'system' | 'light' | 'dark' — The theme of the shared dashboard view. "system" follows your system's default viewing theme.

## Response `200`

OK

- SharedDashboard — The metadata object associated with how a dashboard has been/will be shared.
  - `author` SharedDashboardAuthor — User who shared the dashboard.
    - `handle` string — Identifier of the user who shared the dashboard.
    - `name` string, nullable — Name of the user who shared the dashboard.
  - `created` string, date-time — Date the dashboard was shared.
  - `dashboard_id` string, required — ID of the dashboard to share.
  - `dashboard_type` 'custom_timeboard' | 'custom_screenboard', required — The type of the associated private dashboard.
  - `embeddable_domains` string[] — The `SharedDashboard` `embeddable_domains`.
  - `expiration` string, date-time, nullable — The time when an OPEN shared dashboard becomes publicly unavailable.
  - `global_time` DashboardGlobalTime — Object containing the live span selection for the dashboard.
    - `live_span` '15m' | '1h' | '4h' | '1d' | '2d' | '1w' | '1mo' | '3mo' — Dashboard global time live_span selection
  - `global_time_selectable_enabled` boolean, nullable — Whether to allow viewers to select a different global time setting for the shared dashboard.
  - `invitees` SharedDashboardInviteesItems[] — The `SharedDashboard` `invitees`.
    - `access_expiration` string, date-time, nullable — Time of the invitee expiration. Null means the invite will not expire.
    - `created_at` string, date-time — Time that the invitee was created.
    - `email` string, required — Email of the invitee.
  - `last_accessed` string, date-time, nullable — The last time the shared dashboard was accessed. Null if never accessed.
  - `public_url` string — URL of the shared dashboard.
  - `selectable_template_vars` SelectableTemplateVariableItems[], nullable — List of objects representing template variables on the shared dashboard which can have selectable values.
    - `default_value` string — The default value of the template variable.
    - `name` string — Name of the template variable.
    - `prefix` string — The tag/attribute key associated with the template variable.
    - `type` string, nullable — The type of variable. This is to differentiate between filter variables (interpolated in query) and group by variables (interpolated into group by).
    - `visible_tags` string[], nullable — List of visible tag values on the shared dashboard.
  - `share_list` string[], nullable — List of email addresses that can receive an invitation to access to the shared dashboard.
  - `share_type` 'open' | 'invite' | 'embed', nullable — Type of sharing access (either open to anyone who has the public URL or invite-only).
  - `status` 'active' | 'paused' — Active means the dashboard is publicly available. Paused means the dashboard is not publicly available.
  - `title` string — Title of the shared dashboard.
  - `token` string — A unique token assigned to the shared dashboard.
  - `viewing_preferences` ViewingPreferences — The viewing preferences for a shared dashboard.
    - `high_density` boolean — Whether the widgets on the shared dashboard should be displayed with high density.
    - `theme` 'system' | 'light' | 'dark' — The theme of the shared dashboard view. "system" follows your system's default viewing theme.

## Other responses

- `400` — Bad Request
- `403` — Authentication Error
- `404` — Item Not Found
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v1.md) · [All operations](https://skmtc.net/datadog/apis/api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v1/versions/ca5871004d26/schema)