---
title: "POST /messages/conversations/{conversationId}/participants:remove"
method: POST
path: "/messages/conversations/{conversationId}/participants:remove"
tags: ["ConversationThread"]
---

# POST /messages/conversations/{conversationId}/participants:remove

`POST /messages/conversations/{conversationId}/participants:remove`

remove a participant from a conversation

## Path parameters

- `conversationId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string
- `Repeatability-First-Sent` string, date-time
- `x-ms-client-request-id` string, uuid

## Request body

- RemoveParticipantsOptions — Request payload for removing participants from a conversation.
  - `participantIds` string[], required — The participant IDs to remove.

## Response `207`

Successful

- RemoveParticipantsResult — Response for the remove participants operation.
  - `invalidParticipants` UpdateParticipantsResult[], required — List of Ids with Errors if failed to be added
    - `id` string, required — Participant User Id.
    - `error` AzureCoreFoundationsError — The error object.
      - `code` string, required — One of a server-defined set of error codes.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
      - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
        - `code` string — One of a server-defined set of error codes.
        - `innererror` AzureCoreFoundationsInnerError — recursive

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-messages.md) · [All operations](https://skmtc.net/azure/apis/communication-messages/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-messages/versions/ec11c913a0e6/schema)