Public/Get-GCQualityCalibrations.ps1

<#
.SYNOPSIS
    Retrieves a list of quality calibrations from Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve a paginated list of quality calibrations.
    Supports filtering by calibrator ID.
    API Endpoint: GET /api/v2/quality/calibrations

.PARAMETER PageSize
    The number of results per page. Default is 25.

.PARAMETER PageNumber
    The page number to retrieve. Default is 1.

.PARAMETER CalibratorId
    Filter calibrations by the calibrator's user ID.

.EXAMPLE
    Get-GCQualityCalibrations
    Retrieves the first page of quality calibrations with default page size.

.EXAMPLE
    Get-GCQualityCalibrations -CalibratorId 'user-id-1' -PageSize 50
    Retrieves calibrations for the specified calibrator.

.NOTES
    Genesys Cloud API: GET /api/v2/quality/calibrations
#>

function Get-GCQualityCalibrations {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $false)]
        [int]$PageSize = 25,

        [Parameter(Mandatory = $false)]
        [int]$PageNumber = 1,

        [Parameter(Mandatory = $false)]
        [string]$CalibratorId
    )

    $queryParams = @{
        pageSize   = $PageSize
        pageNumber = $PageNumber
    }

    if ($CalibratorId) { $queryParams['calibratorId'] = $CalibratorId }

    $endpoint = "quality/calibrations"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET -QueryParameters $queryParams
}