Public/Get-GCUserRoutingStatus.ps1

<#
.SYNOPSIS
    Retrieves the routing status of a user in Genesys Cloud.

.DESCRIPTION
    Queries the Genesys Cloud API to retrieve the current routing status of a specific user,
    indicating whether the user is available for routing (ON_QUEUE, OFF_QUEUE, etc.).
    API Endpoint: GET /api/v2/users/{userId}/routingstatus

.PARAMETER UserId
    The unique identifier of the user.

.EXAMPLE
    Get-GCUserRoutingStatus -UserId '12345678-1234-1234-1234-123456789012'
    Retrieves the routing status for the specified user.

.NOTES
    Genesys Cloud API: GET /api/v2/users/{userId}/routingstatus
#>

function Get-GCUserRoutingStatus {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$UserId
    )

    $endpoint = "users/$UserId/routingstatus"
    return Invoke-GCApiRequest -Endpoint $endpoint -Method GET
}