Newer Version Available

This content describes an older version of this product. View Latest

Dashboard Resource

Returns, deletes, or updates the dashboard with the specified ID or API name.
Resource URL
1/wave/dashboards/<dashboardIdOrApiName>
Formats
JSON
Available Version
36.0
Available Components
HTTP Methods
GET DELETE PATCH
GET Response Body (DashboardRepresentation)

DashboardRepresentation inherits properties from the abstract BaseTemplatedAssetRepresentation. These base properties appear in DashboardRepresentation alongside the properties defined explicitly in the following table.

Property Name Type Description Filter Group and Version Available Version
allowPreview Boolean Indicates whether this dashboard is available for preview. Small, 36.0 36.0
current​History​Id String The current saved history to display for the dashboard. If null, the latest dashboard is displayed Small, 44.0 44.0
datasets Asset​Reference​Representation[] The list of datasets used to create this dashboard. Small, 36.0 36.0
date​Version Integer The version of dates used by the dashboard. Valid values are:
  • 1
  • 2
Small, 44.0 44.0
files Lens​File​Representation[] The list of files used to create this dashboard. Medium, 36.0 36.0
files​Url String The URL for the files associated with the dashboard. Small, 36.0 36.0
folder Asset​Reference​Representation[] The folder that contains this dashboard. Small, 36.0 36.0
histories​Url String The URL for the dashboard histories associated with this dashboard. Small, 44.0 44.0
mobile​Disabled Boolean Indicates whether the dashboard is disabled for mobile or not. Small, 41.0 41.0
refresh​Date Date The date of the most recent current dataset that is used by the dashboard, in ISO8601 date format. Small, 36.0 36.0
state Dashboard​State​Representation The state of the dashboard Big, 36.0 36.0
visibility Connect​Wave​Asset​Visibility​Type Indicates whether the asset is hidden from users with view access or not. Valid values are:
  • All (Show all assets)
  • Limited (Hide assets from viewers with view access)
Small, 51.0 51.0
PATCH Request Body (DashboardInputRepresentation)

DashboardInputRepresentation inherits properties from the abstract BaseAssetInputRepresentation. These base properties appear in DashboardInputRepresentation alongside the properties defined explicitly in the following table.

Parameter Name Type Description Required or Optional Available Version
current​History​Id String The current saved history id to display for the dashboard. Optional 44.0
date​Version Integer The version of dates used by the dashboard. Valid values are:
  • 1
  • 2
Optional 44.0
folder Asset​Reference​Input​Representation The folder in which this dashboard is stored. Required for POST, optional for PATCH 44.0
historyLabel String A history label to tag the dashboard version being saved. Optional 44.0
mobileDisabled Boolean Indicates whether the dashboard is disabled for mobile or not. Optional 41.0
state Dashboard​State​Input​Representation The state of the dashboard. Required for POST, optional for PATCH 36.0
type Connect​Wave​Asset​Type​Enum The asset type. The default type is Dashboard. Valid types are:
  • Collection
  • Component
  • Dashboard
  • Dashboard​Snapshot
  • Data​Connector
  • Data​Pool​Entity
  • Data​Pool​Entity​Version
  • Dataflow
  • Dataflow​Job
  • Dataflow​Job​Node
  • Dataset
  • Dataset​Shard
  • Dataset​Version
  • External​Data
  • Folder
  • Lens
  • Lightning​Component
  • Recipe
  • Recipe​Model
  • Replicated​Dataset
  • Story
  • Widget
  • Workflow
Optional 44.0
xmd Xmd​Input​Representation The asset XMD of the dashboard. Optional 44.0
visibility Connect​Wave​Asset​Visibility​Type Indicates whether the asset is hidden from users with view access or not. Valid values are:
  • All (Show all assets)
  • Limited (Hide assets from viewers with view access)
Optional 51.0

The following JSON shows how to edit an existing dashboard description.

1{
2  "description": "This is my dashboard",
3  "label": "Test Dashboard"
4}
PATCH Response Body (DashboardRepresentation)
Property Name Type Description Filter Group and Version Available Version
allowPreview Boolean Indicates whether this dashboard is available for preview. Small, 36.0 36.0
current​History​Id String The current saved history to display for the dashboard. If null, the latest dashboard is displayed Small, 44.0 44.0
datasets Asset​Reference​Representation[] The list of datasets used to create this dashboard. Small, 36.0 36.0
date​Version Integer The version of dates used by the dashboard. Valid values are:
  • 1
  • 2
Small, 44.0 44.0
files Lens​File​Representation[] The list of files used to create this dashboard. Medium, 36.0 36.0
files​Url String The URL for the files associated with the dashboard. Small, 36.0 36.0
folder Asset​Reference​Representation[] The folder that contains this dashboard. Small, 36.0 36.0
histories​Url String The URL for the dashboard histories associated with this dashboard. Small, 44.0 44.0
mobile​Disabled Boolean Indicates whether the dashboard is disabled for mobile or not. Small, 41.0 41.0
refresh​Date Date The date of the most recent current dataset that is used by the dashboard, in ISO8601 date format. Small, 36.0 36.0
state Dashboard​State​Representation The state of the dashboard Big, 36.0 36.0
visibility Connect​Wave​Asset​Visibility​Type Indicates whether the asset is hidden from users with view access or not. Valid values are:
  • All (Show all assets)
  • Limited (Hide assets from viewers with view access)
Small, 51.0 51.0