Allows the app to read and write the signed-in user's sections (folders) for organizing chats and channels in Teams.
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 TeamworkSection.ReadWrite 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
-
70dbe5e8-39b9-40f3-8c65-3ec7b00ad804
DisplayText
-
Read and write your sections
Description
-
Allows the app to read and write the signed-in user's sections (folders) for organizing chats and channels in Teams.
Date and time when the section was created. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
displayIcon
sectionDisplayIcon
The icon displayed for the section.
displayName
String
The display name of the section. Required. Maximum length is 50 characters. Display names are case-sensitive and must be unique within a user's sections. The following names are reserved for system-defined sections and can't be used when creating a user-defined section: RecentChats, QuickViews, TeamsAndChannels, MutedChats, MeetingChats, EngageCommunities.
id
String
The unique identifier for the section. Read-only.
isExpanded
Boolean
Indicates whether the section is expanded in the user interface. The default value is true.
isHierarchicalViewEnabled
Boolean
Indicates whether the hierarchical view is enabled for the section. Read-only.
lastModifiedDateTime
DateTimeOffset
Date and time when the section was last modified. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
sectionType
sectionType
The type of the section. The possible values are: userDefined, systemDefined, unknownFutureValue. Read-only.
sortType
sectionSortType
The sort order of items in the section. The valid values depend on the **s
Date and time when the item was added to the section. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
id
String
The unique identifier for the item. This corresponds to the conversation ID of the underlying chat, channel, meeting, or community. For community items, the service automatically normalizes the ID to the 19:{id}@EngageCommunity format. Read-only.
itemType
sectionItemType
The type of the item. The possible values are: chat, channel, meeting, community, unknownFutureValue. Read-only.
lastModifiedDateTime
DateTimeOffset
Date and time when the item was last modified. Read-only. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z.
The unique identifier for the userTeamwork object.
locale
String
Represents the location that a user selected in Microsoft Teams and doesn't follow the Office's locale setting. A user's locale is represented by their preferred language and country or region. For example, en-us. The language component follows two-letter codes as defined in ISO 639-1, and the country component follows two-letter codes as defined in ISO 3166-1 alpha-2.
region
string
Represents the region of the organization or the user. For users with multigeo licenses, the property contains the user's region (if available). For users without multigeo licenses, the property contains the organization's region.