Microsoft Graph v1.0/teams API is broken

Last Updated on 2021-03-01 10:09:45 UTC

Summary¶

(2020-02-19) our quality management team identified a regression in the Microsoft Graph API (POST v1.0/teams) used in Valo Teamwork to create Microsoft Teams teams with predefined settings, apps, channels, and tabs. If the Valo Teamwork team template contains configuration for Tabs (see example below for a better understanding), the POST v1.0/teams API will fail with an error message similar to this:

{
   "error":{
      "code":"BadRequest",
      "message":"Failed to execute Templates backend request CreateTeamFromTemplateRequest. Request Url: https://teams.microsoft.com/fabric/emea/templates/api/team, Request Method: POST, Response Status Code: BadRequest, Response Headers: Strict-Transport-Security: max-age=2592000x-operationid: 32e057e44a0d6f4db6573946dc15fcfdx-telemetryid: 00-32e057e44a0d6f4db6573946dc15fcfd-20ade0692a92db46-00X-MSEdge-Ref: Ref A: 8AECC984E039443AB1E83EF82CD13757 Ref B: DB3EDGE0719 Ref C: 2021-02-20T07:00:06ZDate: Sat, 20 Feb 2021 07:00:06 GMT, ErrorMessage : {\"errors\":[{\"message\":\"Tabs with duplicate DisplayName are not allowed.\",\"errorCode\":\"Unknown\"},{\"message\":\"'Channel Name' must not be empty.\",\"errorCode\":\"Unknown\"},{\"message\":\"'Channel Name' should not be empty.\",\"errorCode\":\"Unknown\"},{\"message\":\"'Channel Name' must not be empty.\",\"errorCode\":\"Unknown\"},{\"message\":\"'Channel Name' should not be empty.\",\"errorCode\":\"Unknown\"}],\"operationId\":\"32e057e44a0d6f4db6573946dc15fcfd\"}",
      "innerError":{
         "date":"2021-02-20T07:00:06",
         "request-id":"7cb1cac4-9618-4ea6-baf0-9c415ad4a20c",
         "client-request-id":"146e1b6f-49ed-91ed-82c1-1691a5ca21ad"
      }
   }
}

This is what a tab configuration can look like in the Valo Teamwork team template:

<Tab Name="Team info" AppId="2a527703-1f6f-4559-a332-d8a7d288cd88" ResourceId="">
  <Configuration>
    <ContentUrl>{sitecollectionurl}/_layouts/15/teamslogon.aspx?spfx=true&amp;dest={sitecollectionurl}/SitePages/Home.aspx</ContentUrl>
  </Configuration>
</Tab>

The regression in the v1.0/teams API affects all Microsoft customers and can be easily reproduced in Microsoft Graph Explorer.

Latest updates¶

Date (UTC)	Status
2020-03-01 at 11 AM	Valo Teamwork hotfix release 2.1 is out! Please read more on Partner hub
2020-02-25 at 08 PM	The Microsoft Graph Teams team managed to fix the v1.0/teams endpoint. However, they removed support for a tab property called "name" and replaced it with the property "displayName". Since we still use this no longer supported property "name" in our requests to create teams, Valo Teamwork is still not capable of provisioning a team configured with tabs. To solve this problem, we plan to release a hotfix on Feb 26th.
2020-02-24 at 08 AM	Created issue in Microsoft Q&A forum and tagged Microsoft Graph Teams team.
2020-02-22 at 09 AM	Created incident in Valo status site.
2020-02-20 at 08 AM	Contacted Microsoft Graph team directly.
2020-02-19 at 05 PM	Informed Valo partners about issue and contacted Microsoft.
2020-02-19 at 04 PM	Valo quality management team identified regression in POST v1.0/teams API.

Products affected¶

Product name	Version	Status	Comments
Valo Teamwork	1.19 onwards		Valo Teamwork cannot create Microsoft Teams team with predefined tabs.

Expected availability of fix¶

Teamwork¶

The Valo Teamwork hotfix release 2.1 is out.

Mitigation¶

As a workaround, consider removing all tab configuration from your Valo Teamwork teams templates. Valo Teamwork will create the Microsoft Teams team without the tabs. If required, tabs need to be configured manually after teams creation.