Dashboards - Replace Dashboard

Service:

Dashboard

API Version:

5.0-preview.2

Replace configuration for the specified dashboard. Replaces Widget list on Dashboard, only if property is supplied.

HTTP

PUT https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards/{dashboardId}?api-version=5.0-preview.2

URI Parameters

Name	In	Required	Type	Description
dashboardId	path	True	string uuid	ID of the dashboard to replace.
organization	path	True	string	The name of the Azure DevOps organization.
project	path	True	string	Project ID or project name
team	path		string	Team ID or team name
api-version	query	True	string	Version of the API to use. This should be set to '5.0-preview.2' to use this version of the api.

Request Body

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
description	string	Description of the dashboard.
eTag	string	Server defined version tracking value, used for edit collision detection.
id	string	ID of the Dashboard. Provided by service at creation time.
name	string	Name of the Dashboard.
ownerId	string	ID of the Owner for a dashboard. For any legacy dashboards, this would be the unique identifier for the team associated with the dashboard.
position	integer	Position of the dashboard, within a dashboard group. If unset at creation time, position is decided by the service.
refreshInterval	integer	Interval for client to automatically refresh the dashboard. Expressed in minutes.
url	string
widgets	Widget[]	The set of Widgets on the dashboard.

Responses

Name	Type	Description
200 OK	Dashboard	successful operation

Security

accessToken

Personal access token. Use any value for the user name and the token as the password.

Type: basic

Definitions

Name	Description
Dashboard	Model of a Dashboard.
LightboxOptions	Lightbox configuration
ReferenceLinks	The class to represent a collection of REST reference links.
SemanticVersion	versioning for an artifact as described at: http://semver.org/, of the form major.minor.patch.
Widget	Widget data
WidgetPosition
WidgetSize

Dashboard

Object

Model of a Dashboard.

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
description	string	Description of the dashboard.
eTag	string	Server defined version tracking value, used for edit collision detection.
id	string	ID of the Dashboard. Provided by service at creation time.
name	string	Name of the Dashboard.
ownerId	string	ID of the Owner for a dashboard. For any legacy dashboards, this would be the unique identifier for the team associated with the dashboard.
position	integer	Position of the dashboard, within a dashboard group. If unset at creation time, position is decided by the service.
refreshInterval	integer	Interval for client to automatically refresh the dashboard. Expressed in minutes.
url	string
widgets	Widget[]	The set of Widgets on the dashboard.

LightboxOptions

Object

Lightbox configuration

Name	Type	Description
height	integer	Height of desired lightbox, in pixels
resizable	boolean	True to allow lightbox resizing, false to disallow lightbox resizing, defaults to false.
width	integer	Width of desired lightbox, in pixels

ReferenceLinks

Object

The class to represent a collection of REST reference links.

Name	Type	Description
links	object	The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

SemanticVersion

Object

versioning for an artifact as described at: http://semver.org/, of the form major.minor.patch.

Name	Type	Description
major	integer	Major version when you make incompatible API changes
minor	integer	Minor version when you add functionality in a backwards-compatible manner
patch	integer	Patch version when you make backwards-compatible bug fixes

Widget

Object

Widget data

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
allowedSizes	WidgetSize[]	Refers to the allowed sizes for the widget. This gets populated when user wants to configure the widget
areSettingsBlockedForUser	boolean	Read-Only Property from Dashboard Service. Indicates if settings are blocked for the current user.
artifactId	string	Refers to unique identifier of a feature artifact. Used for pinning+unpinning a specific artifact.
configurationContributionId	string
configurationContributionRelativeId	string
contentUri	string
contributionId	string	The id of the underlying contribution defining the supplied Widget Configuration.
dashboard	Dashboard	Optional partial dashboard content, to support exchanging dashboard-level version ETag for widget-level APIs
eTag	string
id	string
isEnabled	boolean
isNameConfigurable	boolean
lightboxOptions	LightboxOptions	Lightbox configuration
loadingImageUrl	string
name	string
position	WidgetPosition
settings	string
settingsVersion	SemanticVersion	versioning for an artifact as described at: http://semver.org/, of the form major.minor.patch.
size	WidgetSize
typeId	string
url	string

WidgetPosition

Object

Name	Type	Description
column	integer
row	integer

WidgetSize

Object

Name	Type	Description
columnSpan	integer	The Width of the widget, expressed in dashboard grid columns.
rowSpan	integer	The height of the widget, expressed in dashboard grid rows.