Public/Get-GCRecordingAnnotations.ps1

<#
.SYNOPSIS
    Retrieves annotations for a recording from Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve all annotations associated with
    a specific recording within a conversation.
    API Endpoint: GET /api/v2/conversations/{conversationId}/recordings/{recordingId}/annotations

.PARAMETER ConversationId
    The unique identifier of the conversation.

.PARAMETER RecordingId
    The unique identifier of the recording whose annotations to retrieve.

.EXAMPLE
    Get-GCRecordingAnnotations -ConversationId 'conv-abc123' -RecordingId 'rec-def456'
    Retrieves all annotations for the specified recording.

.NOTES
    Genesys Cloud API: GET /api/v2/conversations/{conversationId}/recordings/{recordingId}/annotations
#>

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

        [Parameter(Mandatory = $true)]
        [string]$RecordingId
    )

    $endpoint = "conversations/$ConversationId/recordings/$RecordingId/annotations"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET
}