Public/New-GCConversationsCallParticipant.ps1

<#
.SYNOPSIS
    Adds a participant to a call conversation.

.DESCRIPTION
    Adds a new participant (consult, conference) to an existing call conversation in Genesys Cloud.
    Calls POST /api/v2/conversations/calls/{conversationId}/participants.

.PARAMETER ConversationId
    The unique identifier of the call conversation.

.PARAMETER Body
    The request body containing the participant details (e.g., address, userId).

.EXAMPLE
    $participantBody = @{
        address = '+15551234567'
    }
    New-GCConversationsCallParticipant -ConversationId 'conv-id' -Body $participantBody

.NOTES
    Genesys Cloud API: POST /api/v2/conversations/calls/{conversationId}/participants
#>

function New-GCConversationsCallParticipant {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$ConversationId,

        [Parameter(Mandatory = $true)]
        [object]$Body
    )

    $endpoint = "conversations/calls/$ConversationId/participants"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method POST -Body $Body
}