teamsTab resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

A teamsTab is a tab that's pinned (attached) to a channel within a team.


Method Return Type Description
List tabs teamsTab Lists tabs pinned to a channel.
Get tab teamsTab Reads a tab pinned to a channel.
Add tab teamsTab Adds (pins) a tab to a channel.
Delete tab None Removes (unpins) a tab from a channel.
Update tab teamsTab Updates the tab properties.


Property Type Description
id string Identifier that uniquely identifies a specific instance of a channel tab. Read only.
displayName string Name of the tab.
name string (Deprecated) Name of the tab.
teamsAppId string App definition identifier of the tab. This value cannot be changed after tab creation.
sortOrderIndex string Index of the order used for sorting tabs.
webUrl string Deep link URL of the tab instance. Read only.
configuration teamsTabConfiguration Container for custom settings applied to a tab. The tab is considered configured only once this property is set.


Relationship Type Description
teamsApp teamsApp The application that is linked to the tab.

JSON representation

The following is a JSON representation of the resource.

  "id": "string",
  "displayName": "string",
  "teamsAppId": "string",
  "sortOrderIndex": "string",
  "webUrl": "string",
  "configuration": "teamsTabConfiguration",
  "name": "string"

See also

Configuring the built-in tab types