We are attempting to remove a single participant from an active conference call using the Genesys Cloud Conversations API. The documentation suggests using PATCH /api/v2/conversations/conferences/{conferenceId} with a removeParticipants payload. We are sending the correct participant ID in the JSON body, but the API returns a 400 Bad Request. The response indicates the payload structure is invalid. Here is the snippet we are using. Can anyone spot the issue with the nested array format?
You’re hitting a 400 because the payload structure for removeParticipants is stricter than it looks. The API expects an array of participant IDs, not a single string or an object. If you’re sending {"removeParticipants": "123-456"}, it fails. You need to wrap that ID in an array. Also, make sure your Content-Type header is explicitly set to application/json. Sometimes the SDK defaults to form-urlencoded if you’re not careful, and the server rejects that for this endpoint.
Here’s the exact JSON shape that works. You’ll want to hit the conference endpoint with a PATCH method and this body. The id in the URL is the conference ID, not the participant ID. Double-check your auth token has the conversations:modify scope, or you’ll get a 403 instead of a 400. If it still errors, check the request logs for the exact payload sent, because trailing commas or wrong casing on removeParticipants will also break it.
{
"removeParticipants": ["participant-id-here"]
}