Microsoft 365 Microsoft Teams Microsoft Graph

Leverage new Microsoft Teams chat APIs to enable new scenarios

We’ve listened to your feedback and your needs for access to chat APIs in Microsoft Teams to build more scenarios. That’s why we’re excited to announce the general availability of the Microsoft Teams chat APIs in the Microsoft Graph v1.0 endpoint. You can use these APIs to create and update chats, create new messages, and add/remove members from chats. These APIs also allow the caller to add, remove and update tabs inside chats and meetings.

New chat APIs for Microsoft Teams

We have new Teams chat APIs on the Microsoft Graph v1.0 endpoint for you to start using today. The below captures the features that are part of this release:

Create/update chat APIs – You can now create one-on-one and group chats through Microsoft Graph. You can also update the names of existing group chats. These APIs are available with delegated permission.  To learn more, see Create chats.

Membership management APIs – These APIs allow managing a roster of all non-one-on-one chats. In addition to adding and removing users, callers can specify how far back in history a member can see messages. These APIs are available with delegated permission.   To learn more, see conversationMember.

Chat APIs – You can now create a new chatMessage in the specified chat with delegated permission, retrieve the list of messages in a chat and retrieve a single message in a chat by specifying the message id with delegated and application permission. To learn more, see  Send message and List messages in chat

App APIs (CRUD) – You’ve told us that you would like to programmatically install apps (especially bots) inside a meeting.  These APIs allow a caller to add, remove, and upgrade apps inside chats and meetings. If the chat is associated with a meeting, the APIs automatically apply the equivalent app operation to the online meeting instance as well. These APIs are available with delegated and application permission. For details, see teamsAppInstallation.

Tabs APIs (CRUD) – These APIs allow a caller to add and remove tabs inside chats and meetings. If the chat is associated with a meeting, they automatically apply the equivalent tab operation to the online meeting instance as well. These APIs are available with delegated and Application permission. For details, see teamsTab.

Conclusion

We look forward to your feedback on these APIs. Please connect with us on Microsoft Q&A.

Happy coding!

filter-icon