Widget Types - Get Widget Types

Service:: Dashboard

API Version:: 7.1-preview.1

Get all available widget metadata in alphabetical order, including widgets marked with isVisibleFromCatalog == false.

GET https://dev.azure.com/{organization}/{project}/_apis/dashboard/widgettypes?$scope={$scope}&api-version=7.1-preview.1

URI Parameters

Name	In	Required	Type	Description
organization	path	True	string	The name of the Azure DevOps organization.
project	path		string	Project ID or project name
$scope	query	True	WidgetScope
api-version	query	True	string	Version of the API to use. This should be set to '7.1-preview.1' to use this version of the api.

Responses

Name	Type	Description
200 OK	WidgetTypesResponse	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.dashboards	Grants the ability to read team dashboard information

Examples

Sample request

HTTP

GET https://dev.azure.com/fabrikam/_apis/dashboard/widgettypes?api-version=7.1-preview.1

Sample response

Status code:: 200

{
  "widgetTypes": [
    {
      "typeId": "Microsoft.VSO.Dashboards.SprintBurndown",
      "name": "First Party Widget: Sprint Burndown",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintBurndownPreview.png",
      "description": "Used to show the sprint burndown",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "_widgets/SprintBurndown",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "46b71d63-f0e1-4176-b776-7957107f5436",
          "namespace": "dashboards.sprint-burndown V1",
          "version": "0.0.1",
          "name": "Sprint Burndown Widget",
          "description": "Shows the burndown for the current sprint",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintBurndownPreview.png",
          "contributions": {
            "vs.Dashboards.web#widgets": [
              {
                "id": "Microsoft.VSO.Dashboards.SprintBurndown",
                "name": "First Party Widget: Sprint Burndown",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintBurndownPreview.png",
                "description": "Used to show the sprint burndown",
                "uri": "_widgets/SprintBurndown",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:55.103Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widgets",
          "id": "vs.Dashboards.web#widgets"
        },
        "properties": {
          "id": "Microsoft.VSO.Dashboards.SprintBurndown",
          "name": "First Party Widget: Sprint Burndown",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintBurndownPreview.png",
          "description": "Used to show the sprint burndown",
          "uri": "_widgets/SprintBurndown",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VisualStudioOnline.Dashboards.VSLinks",
      "name": "VS Links Widget",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/vsLinksPreview.png",
      "description": "Shows 2 Visual Studio Links, one for download, the other to open VS.",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/VSLinks",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "249960d3-10c0-4b73-aa90-8af01d2fabc7",
          "namespace": "dashboards.vs-links",
          "version": "0.0.1",
          "name": "Visual Studio Links Widget",
          "description": "Shows 2 Visual Studio Links, one for download, the other to open VS",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/vsLinksPreview.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VisualStudioOnline.Dashboards.VSLinks",
                "name": "VS Links Widget",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/vsLinksPreview.png",
                "description": "Shows 2 Visual Studio Links, one for download, the other to open VS.",
                "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/VSLinks",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:55.6Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VisualStudioOnline.Dashboards.VSLinks",
          "name": "VS Links Widget",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/vsLinksPreview.png",
          "description": "Shows 2 Visual Studio Links, one for download, the other to open VS.",
          "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/VSLinks",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VisualStudioOnline.Dashboards.TeamMembers",
      "name": "Team Members Widget",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamMembersPreview.png",
      "description": "Displays the number of team members for the project and a random assortment of team member profile pictures",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamMembers",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "1da91185-b1cd-409a-af57-8e8d414014a1",
          "namespace": "dashboards.team-members",
          "version": "1.0.0",
          "name": "Team Members Widget",
          "description": "Displays the number of team members for the project and a random assortment of team member profile pictures",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamMembersPreview.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VisualStudioOnline.Dashboards.TeamMembers",
                "name": "Team Members Widget",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamMembersPreview.png",
                "description": "Displays the number of team members for the project and a random assortment of team member profile pictures",
                "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamMembers",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:55.383Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VisualStudioOnline.Dashboards.TeamMembers",
          "name": "Team Members Widget",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamMembersPreview.png",
          "description": "Displays the number of team members for the project and a random assortment of team member profile pictures",
          "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamMembers",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VisualStudioOnline.Dashboards.OtherLinks",
      "name": "Other Links Widget",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/otherLinksPreview.png",
      "description": "Shows relavant links for the team.",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/OtherLinks",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "bfb0eae0-a71f-469d-a021-9e650546db6b",
          "namespace": "dashboards.other-links",
          "version": "0.0.1",
          "name": "Other Links Widget",
          "description": "Shows relavant links for the team",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/otherLinksPreview.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VisualStudioOnline.Dashboards.OtherLinks",
                "name": "Other Links Widget",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/otherLinksPreview.png",
                "description": "Shows relavant links for the team.",
                "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/OtherLinks",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:54.827Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VisualStudioOnline.Dashboards.OtherLinks",
          "name": "Other Links Widget",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/otherLinksPreview.png",
          "description": "Shows relavant links for the team.",
          "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/OtherLinks",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VisualStudioOnline.Dashboards.TeamRoom",
      "name": "Team Room Widget",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamRoomPreview.png",
      "description": "Shows current team room status for all teams in the project",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamRoom",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "dba5ed6b-10fe-4469-b1ea-bd57492cdcc7",
          "namespace": "dashboards.team-room",
          "version": "0.0.1",
          "name": "Team Room Widget",
          "description": "Shows current team room status for all teams in the project",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamRoomIcon.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VisualStudioOnline.Dashboards.TeamRoom",
                "name": "Team Room Widget",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamRoomPreview.png",
                "description": "Shows current team room status for all teams in the project",
                "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamRoom",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:55.497Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VisualStudioOnline.Dashboards.TeamRoom",
          "name": "Team Room Widget",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/teamRoomPreview.png",
          "description": "Shows current team room status for all teams in the project",
          "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/TeamRoom",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VisualStudioOnline.Dashboards.WorkLinksWidget",
      "name": "Work Links Widget",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/workLinksPreview.png",
      "description": "Display Work Links",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/WorkLinks",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "340a1bd5-9a00-4e05-a178-e48454e71107",
          "namespace": "dashboards.worklinks",
          "version": "0.0.1",
          "name": "Work Links Widget",
          "description": "Display Work Links",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/workLinksWidgetIcon.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VisualStudioOnline.Dashboards.WorkLinksWidget",
                "name": "Work Links Widget",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/workLinksPreview.png",
                "description": "Display Work Links",
                "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/WorkLinks",
                "isVisibleFromCatalog": true,
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:56.037Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VisualStudioOnline.Dashboards.WorkLinksWidget",
          "name": "Work Links Widget",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}_static/Widgets/workLinksPreview.png",
          "description": "Display Work Links",
          "uri": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"ProjectCollection\"}}{{project.name}}/_widgets/WorkLinks",
          "isVisibleFromCatalog": true,
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    },
    {
      "typeId": "Microsoft.VSO.Dashboards.SprintCapacity",
      "name": "First Party Widget: Sprint Capacity",
      "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintCapacityPreview.png",
      "description": "Used to show the sprint capacity",
      "isVisibleFromCatalog": true,
      "isEnabled": true,
      "contentUri": "_widgets/SprintCapacity",
      "allowedSizes": [
        {
          "rowSpan": 1,
          "columnSpan": 2
        }
      ],
      "contribution": {
        "extension": {
          "id": "53169f02-a2d5-4ae1-8456-fde6c6a9118e",
          "namespace": "dashboards.sprint-capacity V1",
          "version": "0.0.1",
          "name": "Sprint Capacity Widget",
          "description": "Shows the capacity information, user story status in the current sprint",
          "provider": {
            "name": "Microsoft",
            "website": "https://www.microsoft.com"
          },
          "icon": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintCapacityPreview.png",
          "contributions": {
            "vs.Dashboards.web#widget": [
              {
                "id": "Microsoft.VSO.Dashboards.SprintCapacity",
                "name": "First Party Widget: Sprint Capacity",
                "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintCapacityPreview.png",
                "description": "Used to show the sprint capacity",
                "uri": "_widgets/SprintCapacity",
                "supportedSizes": [
                  {
                    "rowSpan": 1,
                    "columnSpan": 2
                  }
                ]
              }
            ]
          },
          "publishInfo": {
            "store": {
              "extensionStoreType": "builtIn",
              "target": "0093aaee-9eff-4562-a0f2-8ea21a4cc590"
            },
            "ownerId": "6915b3ed-b527-4a61-812e-19d0629e2e08",
            "lastUpdated": "2015-05-12T21:18:55.193Z"
          }
        },
        "point": {
          "extensionNamespace": "vs.Dashboards.web",
          "extensionRelativeId": "widget",
          "id": "vs.Dashboards.web#widget"
        },
        "properties": {
          "id": "Microsoft.VSO.Dashboards.SprintCapacity",
          "name": "First Party Widget: Sprint Capacity",
          "previewImageUrl": "{{ServiceUrl \"00025394-6065-48CA-87D9-7F5672854EF7\" \"Application\"}}/_static/Widgets/sprintCapacityPreview.png",
          "description": "Used to show the sprint capacity",
          "uri": "_widgets/SprintCapacity",
          "supportedSizes": [
            {
              "rowSpan": 1,
              "columnSpan": 2
            }
          ]
        }
      }
    }
  ],
  "uri": "https://dev.azure.com/fabrikam/_apis/Dashboard/WidgetTypes"
}

Definitions

Name	Description
LightboxOptions	Lightbox configuration
ReferenceLinks	The class to represent a collection of REST reference links.
WidgetMetadata	Contribution based information describing Dashboard Widgets.
WidgetScope	Data contract required for the widget to function and to work in its container.
WidgetSize
WidgetTypesResponse

LightboxOptions

Object

Lightbox configuration

Name	Type	Description
height	integer (int32)	Height of desired lightbox, in pixels
resizable	boolean	True to allow lightbox resizing, false to disallow lightbox resizing, defaults to false.
width	integer (int32)	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.

WidgetMetadata

Object

Contribution based information describing Dashboard Widgets.

Name	Type	Description
allowedSizes	WidgetSize[]	Sizes supported by the Widget.
analyticsServiceRequired	boolean	Opt-in boolean that indicates if the widget requires the Analytics Service to function. Widgets requiring the analytics service are hidden from the catalog if the Analytics Service is not available.
catalogIconUrl	string	Resource for an icon in the widget catalog.
catalogInfoUrl	string	Opt-in URL string pointing at widget information. Defaults to extension marketplace URL if omitted
configurationContributionId	string	The id of the underlying contribution defining the supplied Widget custom configuration UI. Null if custom configuration UI is not available.
configurationContributionRelativeId	string	The relative id of the underlying contribution defining the supplied Widget custom configuration UI. Null if custom configuration UI is not available.
configurationRequired	boolean	Indicates if the widget requires configuration before being added to dashboard.
contentUri	string	Uri for the widget content to be loaded from .
contributionId	string	The id of the underlying contribution defining the supplied Widget.
defaultSettings	string	Optional default settings to be copied into widget settings.
description	string	Summary information describing the widget.
isEnabled	boolean	Widgets can be disabled by the app store. We'll need to gracefully handle for: - persistence (Allow) - Requests (Tag as disabled, and provide context)
isNameConfigurable	boolean	Opt-out boolean that indicates if the widget supports widget name/title configuration. Widgets ignoring the name should set it to false in the manifest.
isVisibleFromCatalog	boolean	Opt-out boolean indicating if the widget is hidden from the catalog. Commonly, this is used to allow developers to disable creation of a deprecated widget. A widget must have a functional default state, or have a configuration experience, in order to be visible from the catalog.
keywords	string[]	Keywords associated with this widget, non-filterable and invisible
lightboxOptions	LightboxOptions	Opt-in properties for customizing widget presentation in a "lightbox" dialog.
loadingImageUrl	string	Resource for a loading placeholder image on dashboard
name	string	User facing name of the widget type. Each widget must use a unique value here.
publisherName	string	Publisher Name of this kind of widget.
supportedScopes	WidgetScope[]	Data contract required for the widget to function and to work in its container.
tags	string[]	Tags associated with this widget, visible on each widget and filterable.
targets	string[]	Contribution target IDs
typeId	string	Deprecated: locally unique developer-facing id of this kind of widget. ContributionId provides a globally unique identifier for widget types.

WidgetScope

Enumeration

Data contract required for the widget to function and to work in its container.

Value	Description
collection_User
project_Team

WidgetSize

Object

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

WidgetTypesResponse

Object

Name	Type	Description
_links	ReferenceLinks	The class to represent a collection of REST reference links.
uri	string
widgetTypes	WidgetMetadata[]	Contribution based information describing Dashboard Widgets.

Share via

Widget Types - Get Widget Types

URI Parameters

Responses

Security

oauth2

Scopes

Examples

Sample request

Sample response

Definitions

LightboxOptions

ReferenceLinks

WidgetMetadata

WidgetScope

WidgetSize

WidgetTypesResponse