Public/Get-GCRoutingSkills.ps1

<#
.SYNOPSIS
    Retrieves a list of routing skills from Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve a paginated list of routing skills.
    Supports filtering by name.
    API Endpoint: GET /api/v2/routing/skills

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

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

.PARAMETER Name
    Filter skills by name. Supports partial matching.

.EXAMPLE
    Get-GCRoutingSkills
    Retrieves the first page of routing skills.

.EXAMPLE
    Get-GCRoutingSkills -Name 'Billing' -PageSize 50
    Retrieves routing skills matching 'Billing' with 50 results per page.

.NOTES
    Genesys Cloud API: GET /api/v2/routing/skills
#>

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

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

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

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

    if ($Name) { $queryParams['name'] = $Name }

    $endpoint = "routing/skills"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET -QueryParameters $queryParams
}