Dashboards - Replace Dashboards

Reference

Service:: Dashboard

API Version:: 5.0-preview.2

Update the name and position of dashboards in the supplied group, and remove omitted dashboards. Does not modify dashboard content.

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

URI Parameters

Name	In	Required	Type	Description
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.
dashboardEntries	DashboardGroupEntry[]	A list of Dashboards held by the Dashboard Group
permission	GroupMemberPermission	Deprecated: The old permission model describing the level of permissions for the current team. Pre-M125.
teamDashboardPermission	TeamDashboardPermission	A permissions bit mask describing the security permissions of the current team for dashboards. When this permission is the value None, use GroupMemberPermission. Permissions are evaluated based on the presence of a value other than None, else the GroupMemberPermission will be saved.
url	string

Responses

Name	Type	Description
200 OK	DashboardGroup	successful operation

Security

accessToken

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

Type: basic

Examples

Sample Request

HTTP

PUT https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/dashboard/dashboards?api-version=5.0-preview.2

{
  "widgets": []
}

Sample Response

Status code:: 200

{
  "widgets": [],
  "url": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/groups/999EF3B4-93E1-4086-86C2-5E8BD24512C7/Dashboards/7562562a-4f9f-4258-94a9-b048b1c817cf"
    },
    "group": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_apis/Dashboard/Groups/999ef3b4-93e1-4086-86c2-5e8bd24512c7"
    }
  },
  "id": "7562562a-4f9f-4258-94a9-b048b1c817cf",
  "name": "Dashboard98",
  "position": 2,
  "refreshInterval": 5
}

Definitions

Name	Description
Dashboard	Model of a Dashboard.
DashboardGroup	Describes a list of dashboards associated to an owner. Currently, teams own dashboard groups.
DashboardGroupEntry	Dashboard group entry, wraping around Dashboard (needed?)
GroupMemberPermission	Deprecated: The old permission model describing the level of permissions for the current team. Pre-M125.
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.
TeamDashboardPermission	A permissions bit mask describing the security permissions of the current team for dashboards. When this permission is the value None, use GroupMemberPermission. Permissions are evaluated based on the presence of a value other than None, else the GroupMemberPermission will be saved.
Widget	Widget data
WidgetPosition
WidgetSize

Dashboard

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.

DashboardGroup

Describes a list of dashboards associated to an owner. Currently, teams own dashboard groups.

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
dashboardEntries	DashboardGroupEntry[]	A list of Dashboards held by the Dashboard Group
permission	GroupMemberPermission	Deprecated: The old permission model describing the level of permissions for the current team. Pre-M125.
teamDashboardPermission	TeamDashboardPermission	A permissions bit mask describing the security permissions of the current team for dashboards. When this permission is the value None, use GroupMemberPermission. Permissions are evaluated based on the presence of a value other than None, else the GroupMemberPermission will be saved.
url	string

DashboardGroupEntry

Dashboard group entry, wraping around Dashboard (needed?)

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.

GroupMemberPermission

Deprecated: The old permission model describing the level of permissions for the current team. Pre-M125.

Name	Type	Description
edit	string
manage	string
managePermissions	string
none	string

LightboxOptions

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

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

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

TeamDashboardPermission

A permissions bit mask describing the security permissions of the current team for dashboards. When this permission is the value None, use GroupMemberPermission. Permissions are evaluated based on the presence of a value other than None, else the GroupMemberPermission will be saved.

Name	Type	Description
create	string
delete	string
edit	string
managePermissions	string
none	string
read	string

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

Name	Type	Description
column	integer
row	integer

WidgetSize

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.

Share via