Microsoft 365 Chats.conversation Member API
The chats.conversationMember API from Microsoft 365 — 5 operation(s) for chats.conversationmember.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-365:microsoft-365-chats-conversationmember-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Teams Chats.conversation Member API
version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
description: Core
security:
- azureaadv2: []
tags:
- name: chats.conversationMember
paths:
/chats/{chat-id}/members:
get:
tags:
- chats.conversationMember
summary: List conversationMembers
description: List all conversation members in a chat or channel.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/conversationmember-list?view=graph-rest-1.0
operationId: chat_ListMember
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.conversationMemberCollectionResponse'
default:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- chats.conversationMember
summary: Add member to a chat
description: Add a conversationMember to a chat.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-post-members?view=graph-rest-1.0
operationId: chat_CreateMember
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/chats/{chat-id}/members/{conversationMember-id}:
get:
tags:
- chats.conversationMember
summary: Get conversationMember in a chat
description: Retrieve a conversationMember from a chat.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-get-members?view=graph-rest-1.0
operationId: chat_GetMember
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
- name: conversationMember-id
in: path
description: The unique identifier of conversationMember
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: conversationMember
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- chats.conversationMember
summary: Update the navigation property members in chats
operationId: chat_UpdateMember
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
- name: conversationMember-id
in: path
description: The unique identifier of conversationMember
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: conversationMember
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- chats.conversationMember
summary: Remove member from chat
description: Remove a conversationMember from a chat.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/chat-delete-members?view=graph-rest-1.0
operationId: chat_DeleteMember
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
- name: conversationMember-id
in: path
description: The unique identifier of conversationMember
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: conversationMember
- name: If-Match
in: header
description: ETag
style: simple
schema:
type: string
responses:
2XX:
description: Success
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/chats/{chat-id}/members/$count:
get:
tags:
- chats.conversationMember
summary: Get the number of the resource
operationId: chat.member_GetCount
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
/chats/{chat-id}/members/microsoft.graph.add:
post:
tags:
- chats.conversationMember
summary: Invoke action add
description: Add multiple members in a single request to a team. The response provides details about which memberships could and couldn't be created.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/conversationmembers-add?view=graph-rest-1.0
operationId: chat.member_add
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
values:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.actionResultPart'
'@odata.nextLink':
type:
- string
- 'null'
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
/chats/{chat-id}/members/microsoft.graph.remove:
post:
tags:
- chats.conversationMember
summary: Invoke action remove
description: Remove multiple members from a team in a single request. The response provides details about which memberships could and couldn't be removed.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/conversationmember-remove?view=graph-rest-1.0
operationId: chat.member_remove
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: chat
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
values:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
additionalProperties:
type: object
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.actionResultPart'
'@odata.nextLink':
type:
- string
- 'null'
additionalProperties:
type: object
default:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
components:
schemas:
microsoft.graph.actionResultPart:
title: actionResultPart
type: object
properties:
error:
$ref: '#/components/schemas/microsoft.graph.publicError'
additionalProperties:
type: object
microsoft.graph.publicInnerError:
title: publicInnerError
type: object
properties:
code:
type:
- string
- 'null'
description: The error code.
details:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.publicErrorDetail'
description: A collection of error details.
message:
type:
- string
- 'null'
description: The error message.
target:
type:
- string
- 'null'
description: The target of the error.
additionalProperties:
type: object
microsoft.graph.ODataErrors.MainError:
required:
- code
- message
type: object
properties:
code:
type: string
message:
type: string
x-ms-primary-error-message: true
target:
type:
- string
- 'null'
details:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.ErrorDetails'
innerError:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.InnerError'
additionalProperties:
type: object
microsoft.graph.ODataErrors.ODataError:
required:
- error
type: object
properties:
error:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.MainError'
additionalProperties:
type: object
microsoft.graph.publicError:
title: publicError
type: object
properties:
code:
type:
- string
- 'null'
description: Represents the error code.
details:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.publicErrorDetail'
description: Details of the error.
innerError:
$ref: '#/components/schemas/microsoft.graph.publicInnerError'
message:
type:
- string
- 'null'
description: A non-localized message for the developer.
target:
type:
- string
- 'null'
description: The target of the error.
additionalProperties:
type: object
microsoft.graph.ODataErrors.ErrorDetails:
required:
- code
- message
type: object
properties:
code:
type: string
message:
type: string
target:
type:
- string
- 'null'
additionalProperties:
type: object
microsoft.graph.ODataErrors.InnerError:
type: object
additionalProperties:
type: object
description: The structure of this object is service-specific
microsoft.graph.conversationMemberCollectionResponse:
title: Collection of conversationMember
type: object
properties:
value:
type: array
items:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
'@odata.nextLink':
type:
- string
- 'null'
additionalProperties:
type: object
microsoft.graph.publicErrorDetail:
title: publicErrorDetail
type: object
properties:
code:
type:
- string
- 'null'
description: The error code.
message:
type:
- string
- 'null'
description: The error message.
target:
type:
- string
- 'null'
description: The target of the error.
additionalProperties:
type: object
microsoft.graph.conversationMember:
allOf:
- $ref: '#/components/schemas/microsoft.graph.entity'
- title: conversationMember
type: object
properties:
displayName:
type:
- string
- 'null'
description: The display name of the user.
roles:
type: array
items:
type:
- string
- 'null'
description: The roles for that user. This property contains more qualifiers only when relevant - for example, if the member has owner privileges, the roles property contains owner as one of the values. Similarly, if the member is an in-tenant guest, the roles property contains guest as one of the values. A basic member shouldn't have any values specified in the roles property. An Out-of-tenant external member is assigned the owner role.
visibleHistoryStartDateTime:
pattern: ^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$
type:
- string
- 'null'
description: The timestamp denoting how far back a conversation's history is shared with the conversation member. This property is settable only for members of a chat.
format: date-time
additionalProperties:
type: object
ODataCountResponse:
type: integer
format: int32
microsoft.graph.entity:
title: entity
type: object
properties:
id:
type: string
description: The unique identifier for an entity. Read-only.
additionalProperties:
type: object
parameters:
top:
name: $top
in: query
description: Show only the first n items
style: form
explode: false
schema:
minimum: 0
type: integer
example: 50
search:
name: $search
in: query
description: Search items by search phrases
style: form
explode: false
schema:
type: string
skip:
name: $skip
in: query
description: Skip the first n items
style: form
explode: false
schema:
minimum: 0
type: integer
filter:
name: $filter
in: query
description: Filter items by property values
style: form
explode: false
schema:
type: string
count:
name: $count
in: query
description: Include count of items
style: form
explode: false
schema:
type: boolean
responses:
microsoft.graph.conversationMemberCollectionResponse:
description: Retrieved collection
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMemberCollectionResponse'
ODataCountResponse:
description: The count of the resource
content:
text/plain:
schema:
$ref: '#/components/schemas/ODataCountResponse'
error:
description: error
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.ODataErrors.ODataError'
securitySchemes:
azureaadv2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
tokenUrl: https://login.microsoftonline.com/common/oauth2/v2.0/token
scopes: {}