# Microsoft 365 Users.chat API

**Canonical:** https://apis.io/apis/microsoft-365/microsoft-365-users-chat-api/  
**Provider:** Microsoft 365 — https://apis.io/providers/microsoft-365/  
**Base URL:** https://graph.microsoft.com/v1.0/  
**Documentation:** https://learn.microsoft.com/en-us/graph/overview

Microsoft 365 Users.chat API is one of 103 APIs that [Microsoft 365](https://apis.io/providers/microsoft-365/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Users.chat. The published artifact set on APIs.io includes an OpenAPI specification.

The users.chat API from Microsoft 365 — 82 operation(s) for users.chat.

## Operations (60 of 134)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{user-id}/chats` | List chats |
| POST | `/users/{user-id}/chats` | Create new navigation property to chats for users |
| GET | `/users/{user-id}/chats/{chat-id}` | Get chat |
| PATCH | `/users/{user-id}/chats/{chat-id}` | Update the navigation property chats in users |
| DELETE | `/users/{user-id}/chats/{chat-id}` | Delete navigation property chats for users |
| GET | `/users/{user-id}/chats/{chat-id}/installedApps` | Get installedApps from users |
| POST | `/users/{user-id}/chats/{chat-id}/installedApps` | Create new navigation property to installedApps for users |
| GET | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}` | Get installedApps from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}` | Update the navigation property installedApps in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}` | Delete navigation property installedApps for users |
| POST | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}/microsoft.graph.upgrade` | Invoke action upgrade |
| GET | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}/teamsApp` | Get teamsApp from users |
| GET | `/users/{user-id}/chats/{chat-id}/installedApps/{teamsAppInstallation-id}/teamsAppDefinition` | Get teamsAppDefinition from users |
| GET | `/users/{user-id}/chats/{chat-id}/installedApps/$count` | Get the number of the resource |
| GET | `/users/{user-id}/chats/{chat-id}/lastMessagePreview` | Get lastMessagePreview from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/lastMessagePreview` | Update the navigation property lastMessagePreview in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/lastMessagePreview` | Delete navigation property lastMessagePreview for users |
| GET | `/users/{user-id}/chats/{chat-id}/members` | Get members from users |
| POST | `/users/{user-id}/chats/{chat-id}/members` | Create new navigation property to members for users |
| GET | `/users/{user-id}/chats/{chat-id}/members/{conversationMember-id}` | Get members from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/members/{conversationMember-id}` | Update the navigation property members in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/members/{conversationMember-id}` | Delete navigation property members for users |
| GET | `/users/{user-id}/chats/{chat-id}/members/$count` | Get the number of the resource |
| POST | `/users/{user-id}/chats/{chat-id}/members/microsoft.graph.add` | Invoke action add |
| POST | `/users/{user-id}/chats/{chat-id}/members/microsoft.graph.remove` | Invoke action remove |
| GET | `/users/{user-id}/chats/{chat-id}/messages` | Get messages from users |
| POST | `/users/{user-id}/chats/{chat-id}/messages` | Create new navigation property to messages for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}` | Get messages from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}` | Update the navigation property messages in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}` | Delete navigation property messages for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents` | Get hostedContents from users |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents` | Create new navigation property to hostedContents for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}` | Get hostedContents from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}` | Update the navigation property hostedContents in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}` | Delete navigation property hostedContents for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value` | Get media content for the navigation property hostedContents from users |
| PUT | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value` | Update media content for the navigation property hostedContents in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value` | Delete media content for the navigation property hostedContents in users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/hostedContents/$count` | Get the number of the resource |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/microsoft.graph.setReaction` | Invoke action setReaction |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/microsoft.graph.softDelete` | Invoke action softDelete |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/microsoft.graph.undoSoftDelete` | Invoke action undoSoftDelete |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/microsoft.graph.unsetReaction` | Invoke action unsetReaction |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies` | Get replies from users |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies` | Create new navigation property to replies for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}` | Get replies from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}` | Update the navigation property replies in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}` | Delete navigation property replies for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents` | Get hostedContents from users |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents` | Create new navigation property to hostedContents for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}` | Get hostedContents from users |
| PATCH | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}` | Update the navigation property hostedContents in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}` | Delete navigation property hostedContents for users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}/$value` | Get media content for the navigation property hostedContents from users |
| PUT | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}/$value` | Update media content for the navigation property hostedContents in users |
| DELETE | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/{chatMessageHostedContent-id}/$value` | Delete media content for the navigation property hostedContents in users |
| GET | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/hostedContents/$count` | Get the number of the resource |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/microsoft.graph.setReaction` | Invoke action setReaction |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/microsoft.graph.softDelete` | Invoke action softDelete |
| POST | `/users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/microsoft.graph.undoSoftDelete` | Invoke action undoSoftDelete |

…and 74 more operations. They are listed in full on the page.

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/microsoft-365/openapi/microsoft-365-users-chat-api-openapi.yml

## Other Microsoft 365 APIs (12)

- [Microsoft Graph API](https://apis.io/apis/microsoft-365/graph-api/)
- [Microsoft Graph Beta API](https://apis.io/apis/microsoft-365/graph-beta-api/)
- [Microsoft 365 Calendar API](https://apis.io/apis/microsoft-365/microsoft-365-calendar-api/)
- [Microsoft 365 Files API](https://apis.io/apis/microsoft-365/microsoft-365-files-api/)
- [Microsoft 365 Groups API](https://apis.io/apis/microsoft-365/microsoft-365-groups-api/)
- [Microsoft 365 Mail API](https://apis.io/apis/microsoft-365/microsoft-365-mail-api/)
- [Microsoft 365 Me API](https://apis.io/apis/microsoft-365/microsoft-365-me-api/)
- [Microsoft 365 Teams API](https://apis.io/apis/microsoft-365/microsoft-365-teams-api/)
- [Microsoft 365 Users API](https://apis.io/apis/microsoft-365/microsoft-365-users-api/)
- [Microsoft MCP Server for Enterprise](https://apis.io/apis/microsoft-365/mcp-server-enterprise/)
- [Microsoft 365 App Catalogs.teams App API](https://apis.io/apis/microsoft-365/microsoft-365-appcatalogs-teamsapp-api/)
- [Microsoft 365 Chats.chat.Actions API](https://apis.io/apis/microsoft-365/microsoft-365-chats-chat-actions-api/)

## Tags

Users.chat

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/microsoft-365/microsoft-365-users-chat-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/microsoft-365/.