Microsoft 365 Teams.conversation Member API
The teams.conversationMember API from Microsoft 365 — 5 operation(s) for teams.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-teams-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.conversation Member API
version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
description: Core
security:
- azureaadv2: []
tags:
- name: teams.conversationMember
paths:
/teams/{team-id}/members:
get:
tags:
- teams.conversationMember
summary: List members of team
description: Get the conversationMember collection of a team. The membership IDs returned by the server must be treated as opaque strings. The client shouldn't try to parse or make assumptions about these resource IDs. In the future, membership results can include users from various tenants, as indicated in the response. Clients should avoid assuming that all members exclusively belong to the current tenant.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/team-list-members?view=graph-rest-1.0
operationId: team_ListMember
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- $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:
- teams.conversationMember
summary: Add member to team
description: Add a new conversationMember to a team.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/team-post-members?view=graph-rest-1.0
operationId: team_CreateMember
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
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
/teams/{team-id}/members/{conversationMember-id}:
get:
tags:
- teams.conversationMember
summary: Get member of team
description: Get a conversationMember from a team.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/team-get-members?view=graph-rest-1.0
operationId: team_GetMember
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- 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:
- teams.conversationMember
summary: Update member in team
description: Update the role of a conversationMember in a team.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/team-update-members?view=graph-rest-1.0
operationId: team_UpdateMember
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- 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:
- teams.conversationMember
summary: Remove member from team
description: Remove a conversationMember from a team.
externalDocs:
description: Find more info here
url: https://learn.microsoft.com/graph/api/team-delete-members?view=graph-rest-1.0
operationId: team_DeleteMember
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- 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
/teams/{team-id}/members/$count:
get:
tags:
- teams.conversationMember
summary: Get the number of the resource
operationId: team.member_GetCount
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
default:
$ref: '#/components/responses/error'
/teams/{team-id}/members/microsoft.graph.add:
post:
tags:
- teams.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: team.member_add
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
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
/teams/{team-id}/members/microsoft.graph.remove:
post:
tags:
- teams.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: team.member_remove
parameters:
- name: team-id
in: path
description: The unique identifier of team
required: true
style: simple
schema:
type: string
x-ms-docs-key-type: team
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: {}