TeamworkSection.Read
Allows the app to read 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.Readpermission.If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the
Export-MsIdAppConsentGrantReportcommand. See How To: Run a quick OAuth app audit of your tenant
| Category | Application | Delegated |
|---|---|---|
| Identifier | - | 87a3258d-8c34-49e2-ab91-9b8bdbd79177 |
| DisplayText | - | Read your sections |
| Description | - | Allows the app to read the signed-in user's sections (folders) for organizing chats and channels in Teams. |
| AdminConsentRequired | Yes | No |
Graph Methods
→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)
| Methods |
|---|
Resources
Granting this permission allows the calling application to access (and/or update) the following information in your tenant.
Graph reference: teamworkSection
| Property | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | 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 |