Public/Get-GCOutboundRuleSets.ps1

<#
.SYNOPSIS
    Retrieves a list of outbound rule sets from Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve a paginated list of outbound rule sets.
    Supports filtering by name and sorting options.
    API Endpoint: GET /api/v2/outbound/rulesets

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

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

.PARAMETER SortBy
    The field to sort results by.

.PARAMETER SortOrder
    The sort order for results. Valid values are 'ascending' or 'descending'.

.PARAMETER Name
    Filter rule sets by name. Supports partial matching.

.EXAMPLE
    Get-GCOutboundRuleSets
    Retrieves the first page of outbound rule sets with default page size.

.EXAMPLE
    Get-GCOutboundRuleSets -Name 'DNC Rules' -PageSize 50
    Retrieves rule sets matching the name 'DNC Rules'.

.NOTES
    Genesys Cloud API: GET /api/v2/outbound/rulesets
#>

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

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

        [Parameter(Mandatory = $false)]
        [string]$SortBy,

        [Parameter(Mandatory = $false)]
        [string]$SortOrder,

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

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

    if ($SortBy) { $queryParams['sortBy'] = $SortBy }
    if ($SortOrder) { $queryParams['sortOrder'] = $SortOrder }
    if ($Name) { $queryParams['name'] = $Name }

    $endpoint = "outbound/rulesets"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET -QueryParameters $queryParams
}