At the end of July, we will make the following changes to the beta endpoint. APIs on the v1.0 endpoint are not affected. Changes include:
- Different permissions for app installations for a user – To improve security by running with least privilege, we have created new permission scopes for /users/{id}/teamwork/installedApps, and are dropping support for overly broad permissions. See below for details.
- Removing redundant data from code snippets inside chatMessages – In order to simplify the developer experience and reduce payload size, we are removing some unused properties from code snippets. See below for details.
Different permissions for /users/{id}/teamwork/installedApps
We are removing support for User.Read.All, User.ReadWrite.All, Directory.Read.All, and Directory.ReadWrite.All permissions from these APIs:
| GET | /users/{id}/teamwork/installedApps |
| POST | /users/{id}/teamwork/installedApps |
| DELETE | /users/{id}/teamwork/installedApps/{id} |
| POST | /users/{id}/teamwork/installedApps/{id}/upgrade |
Instead, use one of these permissions:
- TeamsAppInstallation.ReadForUser (delegated)
- TeamsAppInstallation.ReadWriteForUser (delegated)
- TeamsAppInstallation.ReadForUser.All (application)
- TeamsAppInstallation.ReadWriteForUser.All (application)
Removing redundant data from code snippets inside chatMessages
Some chatMessages have code snippet cards inside them, embedded in the content property of an attachment. That content itself has a bunch of properties, we are removing some properties that are redundant.
For example, GET /teams/{id}/channels/{id}/messages/{id} returns something like this, we are simplifying the bolded part:
{    “@odata.context”: “https://graph.microsoft.com/beta/$metadata#teams(‘bdb7bcda-9c3b-4341-b9a9-f52bf9a23407’)/channels(‘19%3A786524f437c042b68bac5c0511ad6be2%40thread.skype’)/messages/$entity”,    “id”: “1584126765017”,    “replyToId”: null,    “etag”: “1584126765017”,    “messageType”: “message”,    “createdDateTime”: “2020-03-13T19:12:45.017Z”,    “lastModifiedDateTime”: null,    “deletedDateTime”: null,    “subject”: null,    “summary”: null,    “importance”: “normal”,    “locale”: “en-us”,    “webUrl”: “https://teams.microsoft.com/l/message/19%3A786524f437c042b68bac5c0511ad6be2%40thread.skype/1584126765017?groupId=bdb7bcda-9c3b-4341-b9a9-f52bf9a23407&tenantId=72f988bf-86f1-41af-91ab-2d7cd011db47&createdTime=1584126765017&parentMessageId=1584126765017”,    “policyViolation”: null,    “from”: {        “application”: null,        “device”: null,        “conversation”: null,        “user”: {            “id”: “…”,            “displayName”: “…”,            “userIdentityType”: “aadUser”        }    },    “body”: {        “contentType”: “html”,        “content”: “<div><div>Test</div>\n\n<div> </div>\n\n<div><attachment id=\”8c984810e000471c80fe624a2755444f\”></attachment></div>\n</div>”    },    “attachments”: [        {            “id”: “8c984810e000471c80fe624a2755444f”,            “contentType”: “application/vnd.microsoft.card.codesnippet”,            “contentUrl”: null,            “content”: “{\r\n  \”observers\”: [],\r\n  \”type\”: \”application/vnd.microsoft.card.codesnippet\”,\r\n  \”cardButtons\”: [],\r\n  \”tapButton\”: null,\r\n  \”cardSender\”: null,\r\n  \”replyChainId\”: \”\”,\r\n  \”conversationId\”: \”\”,\r\n  \”alwaysExpand\”: false,\r\n  \”viewOnly\”: false,\r\n  \”clientMessageId\”: \”\”,\r\n  \”serverMessageId\”: \”\”,\r\n  \”messageType\”: \”\”,\r\n  \”isInputExtension\”: false,\r\n  \”hasMentions\”: false,\r\n  \”handler\”: \”codeSnippetDialog_496bb293-6fa6-42c3-a2d8-521fcbd8afff\”,\r\n  \”editable\”: true,\r\n  \”id\”: \”8c984810e000471c80fe624a2755444f\”,\r\n  \”name\”: \”\”,\r\n  \”language\”: \”Text\”,\r\n  \”lines\”: 1,\r\n  \”cardClientId\”: \”8c984810e000471c80fe624a2755444f\”,\r\n  \”wrap\”: false,\r\n  \”codeSnippetUrl\”: \”https://graph.microsoft.com/beta/teams/bdb7bcda-9c3b-4341-b9a9-f52bf9a23407/channels/19:786524f437c042b68bac5c0511ad6be2@thread.skype/messages/1584126765017/hostedContents/aWQ9MC1jdXMtZDEtOGM4MzUzZjkzNjkxNTc2ZjRmMjJlZTRmYTFlMDA3OTYsdHlwZT0wLHVybD0=/$value\”\r\n}”,            “name”: null,            “thumbnailUrl”: null        }    ],    “mentions”: [],    “reactions”: []}
Here’s what that bolded part looks like today when reformatted to be readable:
{    “name”: “”,    “language”: “Text”,    “lines”: 8,    “wrap”: false,    “codeSnippetUrl”: “https://graph.microsoft.com/beta/chats/19:07ad17ad-ada5-4f1f-a650-7a963886a8a7_2de87aaf-844d-4def-9dee-2c317f0be1b3@unq.gbl.spaces/messages/1583878505774/hostedContents/aWQ9MC1jdXMtZDQtMmY0MTY0MmYwZmE1NGQ0MmYxMWY4Mjc3ZTk3NjA0YzAsdHlwZT0wLHVybD0=/$value” ,    “observers”: [], // going away
    “type”: “application/vnd.microsoft.card.codesnippet”, // going away    “cardButtons”: [], // going away    “tapButton”: null, // going away    “cardSender”: null, // going away    “replyChainId”: “”, // going away    “conversationId”: “”, // going away    “alwaysExpand”: false, // going away    “viewOnly”: false, // going away    “clientMessageId”: “”, // going away    “serverMessageId”: “”, // going away    “messageType”: “”, // going away    “isInputExtension”: false, // going away    “hasMentions”: false, // going away    “handler”: “codeSnippetDialog_c4f35431-2b9b-4158-aef4-b377bdc82357”, // going away    “editable”: true, // going away    “id”: “ddd76144c464484ba8c1f42975cfe1ac”, // going away    “cardClientId”: “ddd76144c464484ba8c1f42975cfe1ac” // going away}
Here’s what it will look like after we remove the redundant fields:
{ “name”: “”, “language”: “Text”, “lines”: 8, “wrap”: false, “codeSnippetUrl”: “https://graph.microsoft.com/beta/chats/19:07ad17ad-ada5-4f1f-a650-7a963886a8a7_2de87aaf-844d-4def-9dee-2c317f0be1b3@unq.gbl.spaces/messages/1583878505774/hostedContents/aWQ9MC1jdXMtZDQtMmY0MTY0MmYwZmE1NGQ0MmYxMWY4Mjc3ZTk3NjA0YzAsdHlwZT0wLHVybD0=/$value” }
Tell us what you think
We welcome your feedback. If you have further questions, you can reach out to us on StackOverflow.
-Microsoft Teams
