Disconnecting specific participant from conference via API

NICE CXone API & Integrations
1

Can’t get this config to load properly… I am trying to remove a specific participant from an active conference call using the Genesys Cloud Conversations API. I am sending a POST request to /api/v2/conversations/conferences/{conferenceId}/participants with the correct conversationId and participantId in the JSON body, but the endpoint returns a 404 Not Found.

Here is the payload:

{ "conversationId": "123", "participantId": "456", "action": "remove" }

Is this the correct endpoint for ejecting a user, or should I be using a different method?

2

How I usually solve this is by verifying the resource path. The 404 indicates the conference ID or participant ID is invalid in that context. You are using the wrong endpoint. The POST /participants endpoint adds a participant. To remove one, you must use DELETE /api/v2/conversations/conferences/{conferenceId}/participants/{participantId}.

In .NET SDK, this maps to ConversationsApi.DeleteConversationConferenceParticipant. Ensure the participantId matches the ID returned from the conference details, not the external user ID.

var apiInstance = new ConversationsApi();
var conferenceId = "your-conference-id";
var participantId = "target-participant-id";
await apiInstance.DeleteConversationConferenceParticipant(conferenceId, participantId);

Check your logs for the exact participantId. If it still fails, print the full list of participants to confirm the ID exists in the active session.

3

You need to switch to the DELETE method. The suggestion above is correct. Here is the working curl command:

  1. Verify the conferenceId and participantId.
  2. Execute this request:
curl -X DELETE "https://api.mypurecloud.com/api/v2/conversations/conferences/{conferenceId}/participants/{participantId}" \
 -H "Authorization: Bearer {access_token}"

This fixed my migration script.