Show / Hide Table of Contents

TeamsAppInstallation.ReadWriteSelfForChat

Allows a Teams app to read, install, upgrade, and uninstall itself in chats the signed-in user can access.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 D DELETE /chats/{chat-id}/installedApps/{app-installation-id}
V1 D GET /chats/{chat-id}/installedApps
V1 D GET /chats/{chat-id}/installedApps/{app-installation-id}
V1 D GET /chats/{chat-id}/permissionGrants
V1 D POST /chats/{chat-id}/installedApps
V1 D POST /chats/{chat-id}/installedApps/{app-installation-id}/upgrade

Delegate Permission

Id 0ce33576-30e8-43b7-99e5-62f8569a4002
Consent Type Admin
Display String Allow the Teams app to manage itself in chats
Description Allows a Teams app to read, install, upgrade, and uninstall itself in chats the signed-in user can access.

Resources

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.
lastUpdatedDateTime dateTimeOffset Date and time at which the chat was renamed or list of members were 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 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.

onlineMeeting

Property Type Description
allowAttendeeToEnableCamera Boolean Indicates whether attendees can turn on their camera.
allowAttendeeToEnableMic Boolean Indicates whether attendees can turn on their microphone.
allowedPresenters onlineMeetingPresenters Specifies who can be a presenter in a meeting. Possible values are listed in the following table.
allowMeetingChat meetingChatMode Specifies the mode of meeting chat.
allowTeamworkReactions Boolean Indicates whether Teams reactions are enabled for the meeting.
allowedPresenters onlineMeetingPresenters Specifies who can be a presenter in a meeting. Possible values are listed in the following table.
attendeeReport Stream The content stream of the attendee report of a Microsoft Teams live event. Read-only.
audioConferencing audioConferencing The phone access (dial-in) information for an online meeting. Read-only.
broadcastSettings broadcastMeetingSettings Settings related to a live event.
chatInfo chatInfo The chat information associated with this online meeting.
creationDateTime DateTime The meeting creation time in UTC. Read-only.
endDateTime DateTime The meeting end time in UTC.
id String The default ID associated with the online meeting. Read-only.
isBroadcast Boolean Indicates if this is a Teams live event.
isEntryExitAnnounced Boolean Indicates whether to announce when callers join or leave.
joinInformation itemBody The join information in the language and locale variant specified in the Accept-Language request HTTP header. Read-only.
joinMeetingIdSettings joinMeetingIdSettings Specifies the joinMeetingId, the meeting passcode, and the requirement for the passcode. Once an onlineMeeting is created, the joinMeetingIdSettings cannot be modified. To make any changes to this property, the meeting needs to be canceled and a new one needs to be created.
joinWebUrl String The join URL of the online meeting. Read-only.
lobbyBypassSettings lobbyBypassSettings Specifies which participants can bypass the meeting lobby.
participants meetingParticipants The participants associated with the online meeting. This includes the organizer and the attendees.
recordAutomatically Boolean Indicates whether to record the meeting automatically.
startDateTime DateTime The meeting start time in UTC.
subject String The subject of the online meeting.
videoTeleconferenceId String The video teleconferencing ID. Read-only.

resourceSpecificPermissionGrant

Property Type Description
clientId string ID of the Azure AD app that has been granted access. Read-only.
clientAppId string ID of the service principal of the Azure AD app that has been granted access. Read-only.
deletedDateTime dateTimeOffset Not used.
id string The unique identifier of the resource-specific permission grant. Read-only.
resourceAppId string ID of the Azure AD app that is hosting the resource. Read-only.
permissionType string The type of permission. Possible values are: Application, Delegated. Read-only.
permission string The name of the resource-specific permission. Read-only.

teamsApp

Property Type Description
displayName string The name of the catalog app provided by the app developer in the Microsoft Teams zip app package.
distributionMethod teamsAppDistributionMethod The method of distribution for the app. Read-only.
externalId string The ID of the catalog provided by the app developer in the Microsoft Teams zip app package.
id string The catalog app's generated app ID (different from the developer-provided ID in the Microsoft Teams zip app package.

teamsAppInstallation

Property Type Description
id string A unique ID (not the Teams app ID).

teamworkBot

Property Type Description
id String The ID of the bot associated with the specific teamsAppDefinition. This value is usually a GUID.
In This Article
Back to top Created by merill | Submit feedback