Microsoft 365

Microsoft 365 Users.chat API

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

GitHub OpenAPI

Operations 134

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 #
POST /users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/{chatMessage-id1}/microsoft.graph.unsetReaction Invoke action unsetReaction #
GET /users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/microsoft.graph.delta() Invoke function delta #
POST /users/{user-id}/chats/{chat-id}/messages/{chatMessage-id}/replies/microsoft.graph.replyWithQuote Invoke action replyWithQuote #
GET /users/{user-id}/chats/{chat-id}/messages/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/messages/microsoft.graph.delta() Invoke function delta #
POST /users/{user-id}/chats/{chat-id}/messages/microsoft.graph.replyWithQuote Invoke action replyWithQuote #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.completeMigration Invoke action completeMigration #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.hideForUser Invoke action hideForUser #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.markChatReadForUser Invoke action markChatReadForUser #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.markChatUnreadForUser Invoke action markChatUnreadForUser #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.removeAllAccessForUser Invoke action removeAllAccessForUser #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.sendActivityNotification Invoke action sendActivityNotification #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.startMigration Invoke action startMigration #
POST /users/{user-id}/chats/{chat-id}/microsoft.graph.unhideForUser Invoke action unhideForUser #
GET /users/{user-id}/chats/{chat-id}/permissionGrants Get permissionGrants from users #
POST /users/{user-id}/chats/{chat-id}/permissionGrants Create new navigation property to permissionGrants for users #
GET /users/{user-id}/chats/{chat-id}/permissionGrants/{resourceSpecificPermissionGrant-id} Get permissionGrants from users #
PATCH /users/{user-id}/chats/{chat-id}/permissionGrants/{resourceSpecificPermissionGrant-id} Update the navigation property permissionGrants in users #
DELETE /users/{user-id}/chats/{chat-id}/permissionGrants/{resourceSpecificPermissionGrant-id} Delete navigation property permissionGrants for users #
GET /users/{user-id}/chats/{chat-id}/permissionGrants/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/pinnedMessages Get pinnedMessages from users #
POST /users/{user-id}/chats/{chat-id}/pinnedMessages Create new navigation property to pinnedMessages for users #
GET /users/{user-id}/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id} Get pinnedMessages from users #
PATCH /users/{user-id}/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id} Update the navigation property pinnedMessages in users #
DELETE /users/{user-id}/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id} Delete navigation property pinnedMessages for users #
GET /users/{user-id}/chats/{chat-id}/pinnedMessages/{pinnedChatMessageInfo-id}/message Get message from users #
GET /users/{user-id}/chats/{chat-id}/pinnedMessages/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/tabs Get tabs from users #
POST /users/{user-id}/chats/{chat-id}/tabs Create new navigation property to tabs for users #
GET /users/{user-id}/chats/{chat-id}/tabs/{teamsTab-id} Get tabs from users #
PATCH /users/{user-id}/chats/{chat-id}/tabs/{teamsTab-id} Update the navigation property tabs in users #
DELETE /users/{user-id}/chats/{chat-id}/tabs/{teamsTab-id} Delete navigation property tabs for users #
GET /users/{user-id}/chats/{chat-id}/tabs/{teamsTab-id}/teamsApp Get teamsApp from users #
GET /users/{user-id}/chats/{chat-id}/tabs/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/targetedMessages Get targetedMessages from users #
POST /users/{user-id}/chats/{chat-id}/targetedMessages Create new navigation property to targetedMessages for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id} Get targetedMessages from users #
PATCH /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id} Update the navigation property targetedMessages in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id} Delete navigation property targetedMessages for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents Get hostedContents from users #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents Create new navigation property to hostedContents for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id} Get hostedContents from users #
PATCH /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id} Update the navigation property hostedContents in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id} Delete navigation property hostedContents for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Get media content for the navigation property hostedContents from users #
PUT /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Update media content for the navigation property hostedContents in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Delete media content for the navigation property hostedContents in users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/hostedContents/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies Get replies from users #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies Create new navigation property to replies for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id} Get replies from users #
PATCH /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id} Update the navigation property replies in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id} Delete navigation property replies for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents Get hostedContents from users #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents Create new navigation property to hostedContents for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id} Get hostedContents from users #
PATCH /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id} Update the navigation property hostedContents in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id} Delete navigation property hostedContents for users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Get media content for the navigation property hostedContents from users #
PUT /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Update media content for the navigation property hostedContents in users #
DELETE /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/{chatMessageHostedContent-id}/$value Delete media content for the navigation property hostedContents in users #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/hostedContents/$count Get the number of the resource #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/microsoft.graph.setReaction Invoke action setReaction #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/microsoft.graph.softDelete Invoke action softDelete #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/microsoft.graph.undoSoftDelete Invoke action undoSoftDelete #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/{chatMessage-id}/microsoft.graph.unsetReaction Invoke action unsetReaction #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/$count Get the number of the resource #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/microsoft.graph.delta() Invoke function delta #
POST /users/{user-id}/chats/{chat-id}/targetedMessages/{targetedChatMessage-id}/replies/microsoft.graph.replyWithQuote Invoke action replyWithQuote #
GET /users/{user-id}/chats/{chat-id}/targetedMessages/$count Get the number of the resource #
GET /users/{user-id}/chats/$count Get the number of the resource #
GET /users/{user-id}/chats/microsoft.graph.getAllMessages() Invoke function getAllMessages #
GET /users/{user-id}/chats/microsoft.graph.getAllRetainedMessages() Invoke function getAllRetainedMessages #

Specifications

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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/microsoft-365:microsoft-365-users-chat-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-365-users-chat-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Teams Users.chat API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (262 KB total) ---
# Full source: https://artifacts.apis.io/microsoft-365/openapi/microsoft-365-users-chat-api-openapi.yml