TeamsTab.ReadWrite.All

Read and write tabs in any team in Microsoft Teams, on behalf of the signed-in user. This does not give access to the content inside the tabs.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the TeamsTab.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	a96d855f-016b-47d7-b51c-1218a98d791c	b98bfd41-87c6-45cc-b104-e2de4f0dafb9
DisplayText	Read and write tabs in Microsoft Teams.	Read and write tabs in Microsoft Teams.
Description	Read and write tabs in any team in Microsoft Teams, without a signed-in user. This does not give access to the content inside the tabs.	Read and write tabs in any team in Microsoft Teams, on behalf of the signed-in user. This does not give access to the content inside the tabs.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /chats/{chat-id}/tabs/{tab-id}
	DELETE /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	GET /chats/{chat-id}/tabs
	GET /chats/{chat-id}/tabs/{tab-id}
	GET /teams/{id}/channels/{id}/tabs
	GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	PATCH /chats/{chat-id}/tabs/{tab-id}
	PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	POST /chats/{chat-id}/tabs
	POST /teams/{team-id}/channels/{channel-id}/tabs

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /chats/{chat-id}/tabs/{tab-id}
	DELETE /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	GET /chats/{chat-id}/tabs
	GET /chats/{chat-id}/tabs/{tab-id}
	GET /teams/{team-id}/channels/{channel-id}/tabs
	GET /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	PATCH /chats/{chat-id}/tabs/{tab-id}
	PATCH /teams/{team-id}/channels/{channel-id}/tabs/{tab-id}
	POST /chats/{chat-id}/tabs
	POST /teams/{id}/channels/{id}/tabs

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgChatTab
	Get-MgTeamChannelTab
	New-MgChatTab
	New-MgTeamChannelTab
	Remove-MgChatTab
	Remove-MgTeamChannelTab
	Update-MgChatTab
	Update-MgTeamChannelTab

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaChatTab
	Get-MgBetaTeamChannelTab
	New-MgBetaChatTab
	New-MgBetaTeamChannelTab
	Remove-MgBetaChatTab
	Remove-MgBetaTeamChannelTab
	Update-MgBetaChatTab
	Update-MgBetaTeamChannelTab

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: channel

Property	Type	Description
createdDateTime	dateTimeOffset	Read only. Timestamp at which the channel was created.
description	String	Optional textual description for the channel.
displayName	String	Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters.
email	String	The email address for sending messages to the channel. Read-only.
id	String	The channel's unique identifier. Read-only.
isArchived	Boolean	Indicates whether the channel is archived. Read-only.
isFavoriteByDefault	Boolean	Indicates whether the channel should be marked as recommended for all members of the team to show in their channel list. Note: All recommended channels automatically show in the channels list for education and frontline worker users. The property can only be set programmatically via the Create team method. The default value is `false`.
membershipType	channelMembershipType	The type of the channel. Can be set during creation and can't be changed. The possible values are: `standard`, `private`, `unknownFutureValue`, `shared`. The default value is `standard`. Use the `Prefer: include-unknown-enum-members` request header to get the following value in this evolvable enum: `shared`.
tenantId	string	The ID of the Microsoft Entra tenant.
webUrl	String	A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only.
summary	channelSummary	Contains summary information about the channel, including number of owners, members, guests, and an indicator for members from other tenants. The **s

Graph reference: chat

Property	Type	Description
chatType	chatType	Specifies the type of chat. Possible values are: `group`, `oneOnOne`, `meeting`, `unknownFutureValue`.
createdDateTime	dateTimeOffset	Date and time at which the chat was created. Read-only.
id	String	The chat's unique identifier. Read-only.
isHiddenForAllMembers	Boolean	Indicates whether the chat is hidden for all its members. Read-only.
lastUpdatedDateTime	dateTimeOffset	Date and time at which the chat was renamed or the list of members was last changed. Read-only.
onlineMeetingInfo	teamworkOnlineMeetingInfo	Represents details about an online meeting. If the chat isn't associated with an online meeting, the property is empty. Read-only.
tenantId	String	The identifier of the tenant in which the chat was created. Read-only.
topic	String	(Optional) Subject or topic for the chat. Only available for group chats.
viewpoint	chatViewpoint	Represents caller-specific information about the chat, such as the last message read date and time. This property is populated only when the request is made in a delegated context.
webUrl	String	The URL for the chat in Microsoft Teams. The URL should be treated as an opaque blob, and not parsed. Read-only.

Graph reference: onlineMeeting

Property	Type	Description
allowAttendeeToEnableCamera	Boolean	Indicates whether attendees can turn on their camera. Inherited from onlineMeetingBase.
allowAttendeeToEnableMic	Boolean	Indicates whether attendees can turn on their microphone. Inherited from onlineMeetingBase.
allowBreakoutRooms	Boolean	Indicates whether breakout rooms are enabled for the meeting. Inherited from onlineMeetingBase.
allowedLobbyAdmitters	allowedLobbyAdmitterRoles	Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowedPresenters	onlineMeetingPresenters	Specifies who can be a presenter in a meeting. Possible values are listed in the following table. Inherited from onlineMeetingBase.
allowLiveShare	meetingLiveShareOptions	Indicates whether live share is enabled for the meeting. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowMeetingChat	meetingChatMode	Specifies the mode of meeting chat. Inherited from onlineMeetingBase.
allowParticipantsToChangeName	Boolean	Specifies if participants are allowed to rename themselves in an instance of the meeting. Inherited from onlineMeetingBase.
allowPowerPointSharing	Boolean	Indicates whether PowerPoint live is enabled for the meeting. Inherited from onlineMeetingBase.
allowTeamworkReactions	Boolean	Indicates whether Teams reactions are enabled for the meeting. Inherited from onlineMeetingBase.
allowRecording	Boolean	Indicates whether recording is enabled for the meeting. Inherited from onlineMeetingBase.
allowTeamworkReactions	Boolean	Indicates whether Teams reactions are enabled for the meeting. Inherited from onlineMeetingBase.
allowTranscription	Boolean	Indicates whether transcription is enabled for the meeting. Inherited from onlineMeetingBase.
allowWhiteboard	Boolean	Indicates whether whiteboard is enabled for the meeting. Inherited from onlineMeetingBase.
audioConferencing	audioConferencing	The phone access (dial-in) information for an online meeting. Read-only. Inherited from onlineMeetingBase.
chatInfo	chatInfo	The chat information associated with this online meeting. Inherited from onlineMeetingBase.
chatRestrictions	chatRestrictions	Specifies the configuration settings for meeting chat restrictions. Inherited from onlineMeetingBase.
creationDateTime	DateTime	The meeting creation time in UTC. Read-only.
endDateTime	DateTime	The meeting end time in UTC. Required when you create an online meeting.
joinWebUrl	String	The join URL of the online meeting. The format of the URL may change; therefore, users shouldn't rely on any information extracted from parsing the URL. Read-only. Inherited from onlineMeetingBase.
participants	meetingParticipants	The participants associated with the online meeting, including the organizer and the attendees.
subject	String	The subject of the online meeting. Required when you create an online meeting.
id	String	The default ID associated with the online meeting. Read-only. Inherited from onlineMeetingBase.
isEntryExitAnnounced	Boolean	Indicates whether to announce when callers join or leave. Inherited from onlineMeetingBase.
joinInformation	itemBody	The join information in the language and locale variant specified in the `Accept-Language` request HTTP header. Read-only. Inherited from onlineMeetingBase.
joinMeetingIdSettings	joinMeetingIdSettings	Specifies the joinMeetingId, the meeting passcode, and the requirement for the passcode. Once an onlineMeeting is created, the joinMeetingIdSettings can't be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created. Inherited from onlineMeetingBase.
lobbyBypassSettings	lobbyBypassSettings	Specifies which participants can bypass the meeting lobby. Inherited from onlineMeetingBase.
meetingTemplateId	String	The ID of the meeting template.
recordAutomatically	Boolean	Indicates whether to record the meeting automatically. Inherited from onlineMeetingBase.
shareMeetingChatHistoryDefault	meetingChatHistoryDefaultMode	Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from onlineMeetingBase.
startDateTime	DateTime	The meeting start time in UTC.
videoTeleconferenceId	String	The video teleconferencing ID. Read-only. Inherited from onlineMeetingBase.
watermarkProtection	watermarkProtectionValues	Specifies whether the client application should apply a watermark a content type. Inherited from onlineMeetingBase.
attendeeReport (deprecated)	Stream	The content stream of the attendee report of a Microsoft Teams live event. Read-only.
broadcastSettings (deprecated)	broadcastMeetingSettings	Settings related to a live event.
isBroadcast (deprecated)	Boolean	Indicates whether this meeting is a Teams live event.

Graph reference: team

Property	Type	Description
id	string	The unique identifier of the team. The group has the same ID as the team. This property is read-only, and is inherited from the base entity type.
classification	string	An optional label. Typically describes the data or business sensitivity of the team. Must match one of a preconfigured set in the tenant's directory.
classSettings	teamClassSettings	Configure settings of a class. Available only when the team represents a class.
createdDateTime	dateTimeOffset	Timestamp at which the team was created.
description	string	An optional description for the team. Maximum length: 1,024 characters.
displayName	string	The name of the team.
firstChannelName	String	The name of the first channel in the team. This is an optional property, only used during team creation and isn't returned in methods to get and list teams.
funSettings	teamFunSettings	Settings to configure use of Giphy, memes, and stickers in the team.
guestSettings	teamGuestSettings	Settings to configure whether guests can create, update, or delete channels in the team.
internalId	string	A unique ID for the team that was used in a few places such as the audit log/Office 365 Management Activity API.
isArchived	Boolean	Whether this team is in read-only mode.
memberSettings	teamMemberSettings	Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettings	teamMessagingSettings	Settings to configure messaging and mentions in the team.
specialization	teamSpecialization	Optional. Indicates whether the team is intended for a particular use case. Each team specialization has access to unique behaviors and experiences targeted to its use case.
summary	teamSummary	Contains summary information about the team, including number of owners, members, and guests.
tenantId	string	The ID of the Microsoft Entra tenant.
visibility	teamVisibilityType	The visibility of the group and team. Defaults to Public.
webUrl	string (readonly)	A hyperlink that goes to the team in the Microsoft Teams client. You get this URL when you right-click a team in the Microsoft Teams client and select **G

Graph reference: teamsTab

Property	Type	Description
configuration	teamsTabConfiguration	Container for custom settings applied to a tab. The tab is considered configured only once this property is set.
displayName	string	Name of the tab.
id	string	Identifier that uniquely identifies a specific instance of a channel tab. Read only.
webUrl	string	Deep link URL of the tab instance. Read only.

Table of Contents

TeamsTab.ReadWrite.All

Graph Methods

Resources