Magidoc

updateDashboardV2
Mutation

Updates a Hive dashboard, including its title, sharing, filters, styling, and layout. Dashboard layout uses a 48-column grid; provide layout only for an explicit widget move or resize request.

Arguments

#

_id

ID !
Non-null

Dashboard ID to update

title

New dashboard title

privacy

New privacy setting

projectIds

[ID ]

Updated project IDs for access

sharingWith

[ID !]

Updated user IDs to share with

teams

[ID !]

Updated team IDs to share with

layout

Widget positions and sizes on the dashboard's 48-column grid. Omit for title, privacy, filter, or styling updates. Pass only when the user explicitly asked to rearrange, resize, or move widgets; confirm with the user before sending layout.

filter

The dashboard filter the widgets follow. It replaces the whole filter, so send every filter that should stay (read the dashboard first, and keep pinnedFilters and lockedFilters) and list each one's key in selectedFilters.

shareOnBehalfOfCreator

Whether to share on behalf of creator

shareOnBehalfOfCreatorSettings

pinToUser

Whether to pin dashboard to user

color

Updated dashboard color

allowedEmailDomains

Updated allowed email domains

allowAccessToWhitelistedDomains

Whether to allow whitelisted domain access

backgroundColor

Updated background color

customBackgroundColor

Updated custom background color

backgroundImageUrl

Updated background image URL

backgroundImageUrlLight

Updated background image URL for light theme

backgroundImageUrlDark

Updated background image URL for dark theme

backgroundImageCropType

Updated background image crop type

displayTipsAndTricksFooter

Whether to display tips footer

headerTextColor

Updated header text color

customHeaderTextColor

Updated custom header text color

archived

Toggle archived state

showHeaderOnPublicShare

Show the dashboard header on the public share link

showHeaderOnExport

Show the dashboard header on PDF exports

showDateFiltersOnWidgets

Show effective date-filter labels under chart/pivot widget titles

pdfPaperSize

Default PDF paper size for print preview and export

exportPdfPaperSize

Default PDF paper size for menu export and scheduled email PDFs

pdfExportLayout

Upsert one user-reviewed PDF layout, or clear every saved layout with null.

Response

#

Returns Dashboard .

Example

#